trello-mcp
Local MCP server (stdio) that lets Claude Code manage Trello tickets — boards, lists, cards, comments, checklists, labels, members.
Setup
1. Get API key + token
You already have an API key from the Trello power-up admin page. You also need a Token (not the OAuth secret).
Open this URL in a browser, replacing <API_KEY>:
https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=ClaudeMCP&key=<API_KEY>
Approve, copy the resulting token.
2. Configure .env
cp .env.example .env
$EDITOR .env # paste TRELLO_API_KEY and TRELLO_TOKEN
TRELLO_DEFAULT_BOARD is optional — set it to a board ID and tools that take board_id will use it when you omit the argument. To find a board's ID, open the board in the browser and append .json to the URL, or call list_boards once after the server is running.
3. Install deps
uv sync
4. Register with Claude Code
claude mcp add trello --scope user -- \
uv run --directory "$(pwd)" trello-mcp
Verify:
claude mcp list
Restart any open Claude Code session, then in Claude run /mcp — you should see trello connected with 16 tools.
Tools
Read: list_boards, list_lists, list_cards, get_card, list_labels, list_board_members
Card CRUD: create_card, update_card, move_card, archive_card
Annotations: add_comment, add_checklist, add_checklist_item, set_check_item, add_label, assign_member
Manual smoke test
uv run fastmcp dev src/trello_mcp/server.py
Opens the MCP Inspector — try list_boards first.
