Trello MCP Server
Manage Trello boards, lists, and cards from any MCP-compatible AI assistant
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
fastmcp-trelloclaude mcp add trello-mcp-server -e 'TRELLO_API_KEY=<your trello_api_key>' -e 'TRELLO_TOKEN=<your trello_token>' -- uvx fastmcp-trello==0.5.0
{
"mcpServers": {
"trello-mcp-server": {
"command": "uvx",
"args": [
"fastmcp-trello==0.5.0"
],
"env": {
"TRELLO_API_KEY": "<your trello_api_key>",
"TRELLO_TOKEN": "<your trello_token>"
}
}
}
}
Environment variables
TRELLO_API_KEYrequired secret Trello API key from https://trello.com/power-ups/adminTRELLO_TOKENrequired secret Trello API token
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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.
License
Frequently asked questions
What is Trello MCP Server?
Manage Trello boards, lists, and cards from any MCP-compatible AI assistant
How do I install Trello MCP Server?
It runs on your machine. In Claude Code: claude mcp add trello-mcp-server -e 'TRELLO_API_KEY=<your trello_api_key>' -e 'TRELLO_TOKEN=<your trello_token>' -- uvx fastmcp-trello==0.5.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Trello MCP Server need an API key?
Yes. It expects TRELLO_API_KEY, TRELLO_TOKEN, which you set in its configuration.
Is Trello MCP Server open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Trello MCP Server?
It is published by Jimdrews. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.