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.