trello-mcp

本地 MCP 服务器 (stdio)，允许 Claude Code 管理 Trello 工单——包括看板、列表、卡片、评论、清单、标签和成员。

设置

1. 获取 API 密钥和令牌

你已经从 Trello Power-Up 管理页面获得了 API 密钥。你还需要一个 令牌 (Token)（不是 OAuth 密钥）。

在浏览器中打开此 URL，替换 <API_KEY>：

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=ClaudeMCP&key=<API_KEY>

批准并复制生成的令牌。

2. 配置 .env

cp .env.example .env
$EDITOR .env   # paste TRELLO_API_KEY and TRELLO_TOKEN

TRELLO_DEFAULT_BOARD 是可选的——将其设置为看板 ID，当你在工具调用中省略 board_id 参数时，工具将使用该默认值。要查找看板的 ID，请在浏览器中打开看板并在 URL 后添加 .json，或者在服务器运行后调用一次 list_boards。

3. 安装依赖

uv sync

4. 在 Claude Code 中注册

claude mcp add trello --scope user -- \
  uv run --directory "$(pwd)" trello-mcp

验证：

claude mcp list

重启任何打开的 Claude Code 会话，然后在 Claude 中运行 /mcp ——你应该能看到 trello 已连接并包含 16 个工具。

工具

读取：list_boards, list_lists, list_cards, get_card, list_labels, list_board_members

卡片增删改查 (CRUD)：create_card, update_card, move_card, archive_card

标注：add_comment, add_checklist, add_checklist_item, set_check_item, add_label, assign_member

手动冒烟测试

uv run fastmcp dev src/trello_mcp/server.py

打开 MCP Inspector ——先尝试 list_boards。