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:
- Go to the Trello Power-Ups admin page
- Create a new Power-Up (any name/workspace will do)
- Generate a new API key
- 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.