Trello MCP Server
MCP server for the Trello REST API – manage boards, lists, cards, labels, checklists and more
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).
trello-mcpclaude mcp add trello-mcp-server -e 'TRELLO_API_KEY=<your trello_api_key>' -e 'TRELLO_TOKEN=<your trello_token>' -- uvx trello-mcp==1.6.0
{
"mcpServers": {
"trello-mcp-server": {
"command": "uvx",
"args": [
"trello-mcp==1.6.0"
],
"env": {
"TRELLO_API_KEY": "<your trello_api_key>",
"TRELLO_TOKEN": "<your trello_token>"
}
}
}
}
Environment variables
TRELLO_API_KEYrequired secret API key from Trello Power-Up admin (https://trello.com/power-ups/admin)TRELLO_TOKENrequired secret User token generated for your Trello API key
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Trello MCP Server
An MCP server for the Trello REST API. Manage boards, lists, cards, labels, checklists, and more from any MCP-compatible client.
Tools
| Tool | Description |
|---|---|
list_my_boards | List all boards for the authenticated user |
get_board | Get details of a single board |
get_board_lists | Get all lists on a board |
create_list | Create a new list on a board |
get_list_cards | Get all cards in a list |
get_board_cards | Get all cards on a board |
get_card | Get details of a single card |
create_card | Create a new card in a list |
update_card | Update one or more fields on a card |
move_card | Move a card to a different list/board |
archive_card | Archive (close) a card |
get_card_comments | Get all comments on a card |
add_card_comment | Add a comment to a card |
get_card_attachments | Get all attachments on a card |
add_card_attachment | Upload a file as an attachment to a card |
add_card_url_attachment | Attach a URL to a card |
delete_card_attachment | Delete an attachment from a card |
get_board_labels | Get all labels on a board |
create_label | Create a label on a board |
get_card_checklists | Get all checklists on a card |
get_checklist | Get a checklist and its items |
create_checklist | Create a checklist on a card |
add_checklist_item | Add an item to a checklist |
get_me | Get the authenticated member's profile |
search_trello | Search for cards and/or boards |
get_card_history | Get the action history of a card (moves, edits, comments, etc.) |
Prerequisites
- Go to trello.com/power-ups/admin and create a new Power-Up
- Copy your API Key
- Generate a Token using the link on the same page
Installation
uvx trello-mcp
Or install from PyPI:
pip install trello-mcp
Usage
Claude Desktop / Claude Code
Add to your .mcp.json:
{
"mcpServers": {
"trello": {
"command": "uvx",
"args": ["trello-mcp"],
"env": {
"TRELLO_API_KEY": "your-api-key",
"TRELLO_TOKEN": "your-token"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
TRELLO_API_KEY | Yes | API key from Trello Power-Up admin |
TRELLO_TOKEN | Yes | User token generated for your API key |
Development
git clone https://github.com/stucchi/trello-mcp.git
cd trello-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest
License
MIT
Frequently asked questions
What is Trello MCP Server?
MCP server for the Trello REST API – manage boards, lists, cards, labels, checklists and more
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 trello-mcp==1.6.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?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Trello MCP Server?
It is published by stucchi. 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.