Trello MCP Server

<p align="center"> <img src="banner.svg" alt="fastmcp-trello" width="100%"> </p>

   

A Trello MCP server — manage boards, cards, and lists from any AI assistant that supports the Model Context Protocol. MCP is an open standard that lets AI assistants like Claude, Cursor, and Copilot interact with external tools and services.

Trello MCP Tools

| Tool | Description | |---|---| | get_boards | List all boards accessible to you | | get_board | Get a board's details including its lists | | get_lists | Get all open lists on a board | | create_board | Create a new board | | update_board | Update a board's name or description | | close_board | Close (archive) a board | | get_cards | Get all cards in a list | | get_card | Get full details for a card including comments | | create_card | Create a new card on a list | | update_card | Update a card's fields or move it to a different list | | archive_card | Archive (close) a card | | get_labels | Get all labels defined on a board | | create_label | Create a new label on a board | | delete_label | Delete a label from a board | | add_label_to_card | Add a label to a card | | remove_label_from_card | Remove a label from a card | | create_list | Create a new list on a board | | update_list | Rename a list | | archive_list | Archive (close) a list | | move_list | Move a list to a new position | | get_attachments | Get all attachments on a card | | add_attachment | Add a URL attachment to a card | | delete_attachment | Delete an attachment from a card | | add_comment | Add a comment to a card | | search_cards | Search for cards across boards, optionally scoped to a specific board |

Prerequisites

You need a Trello API key and token:

1. Go to the Trello Power-Ups admin page
2. Create a new Power-Up (any name/workspace will do)
3. Generate a new API key
4. From the API key page, click the Token link to generate a token

Installation

Add the following to your MCP client configuration (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["fastmcp-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Or run standalone:

TRELLO_API_KEY=your-api-key TRELLO_TOKEN=your-token uvx fastmcp-trello

Usage

Once installed in your MCP client, you can ask your AI assistant things like:

"Show me all my Trello boards"

"Create a card called 'Fix login bug' in the To Do list on my Project board"

Configuration

| Variable | Required | Description | |---|---|---| | TRELLO_API_KEY | Yes | Your Trello API key | | TRELLO_TOKEN | Yes | Your Trello authentication token |

Development

git clone https://github.com/Jimdrews/fastmcp-trello.git
cd fastmcp-trello
uv sync --group dev
uv run pytest

See CONTRIBUTING.md for more details.

License

MIT

<!-- mcp-name: io.github.Jimdrews/fastmcp-trello -->