[](https://pypi.org/project/fastmcp-trello/) [](https://pypi.org/project/fastmcp-trello/) [](https://github.com/Jimdrews/fastmcp-trello/actions/workflows/ci.yml) [](https://opensource.org/licenses/MIT) A Trello MCP server — manage boards, cards, and lists from any AI assistant that supports the [Model Context Protocol](https://modelcontextprotocol.io). 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](https://trello.com/power-ups/admin) 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.): ```json { "mcpServers": { "trello": { "command": "uvx", "args": ["fastmcp-trello"], "env": { "TRELLO_API_KEY": "your-api-key", "TRELLO_TOKEN": "your-token" } } } } ``` Or run standalone: ```bash 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 ```bash git clone https://github.com/Jimdrews/fastmcp-trello.git cd fastmcp-trello uv sync --group dev uv run pytest ``` See [CONTRIBUTING.md](CONTRIBUTING.md) for more details. ## License [MIT](LICENSE)