About Trello MCP Server
Trello MCP Server connects MCP-compatible clients to the Trello REST API. It supports managing boards and their contents, including cards, labels, checklists, comments, and attachments.
Key features
- 01Browse boards, lists, and cards
- 02Create and update lists and cards
- 03Move and archive cards
- 04Manage comments and attachments
- 05Manage labels and checklists
- 06Search boards and cards; view card history
Use cases
- 01Review cards and board contents from an MCP client
- 02Create or move cards as work changes
- 03Add comments, files, or checklist items to cards
MCP support
It exposes Trello REST API operations as tools for MCP-compatible clients, covering boards, cards, and related data.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
uvx trello-mcpTRELLO_API_KEYSecretAPI key from Trello Power-Up admin (https://trello.com/power-ups/admin)TRELLO_TOKENSecretUser token generated for your Trello API keyLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMETrello 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.