Trello MCP Server

社区

通过 Claude 等 MCP 客户端管理 Trello 看板、列表与卡片。

分类: 团队协作第 39 / 55
Stars: ★ 54 热门
传输方式: stdio（本地进程） · SSE
运行环境: Python 3.12+ · Docker
凭据: 需要 API Key / 凭据
最近提交: 4 个月前

47FMRS · D

这是一个功能明确、文档清晰的社区版 Trello MCP 服务器：看板仅可读，列表/卡片/检查清单支持完整的增删改查，并提供 Claude App、SSE 和 Docker 三种部署方式。使用前需注意妥善保管 Trello API 凭据，并了解删除类操作不可撤销。

最强项 · 文档质量 14/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

8/20

维护活跃度

7/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: README 描述了一份工具能力表（看板/列表/卡片/清单/清单项的读写增删),但仓库中未提供任何测试文件、CI 工作流或可复现的运行日志作为证据,无法验证声明的工具是否与实际行为一致,也无法判断错误处理与依赖是否可控。按静态评审规则,没有可验证的执行证据(真实 CI + 已提交测试覆盖关键路径),可靠性不得超过 12 分,又因完全缺乏任何执行/测试证据,进一步下调至 6 分。
安全与权限 8/20: 凭据通过 .env 文件中的 TRELLO_API_KEY/TRELLO_TOKEN 管理,属于常规做法,未见明文令牌泄露示例。但 SSE 模式默认监听 0.0.0.0:8000 且文档未提及任何身份验证或访问控制机制,存在被本地网络其他主体访问的风险。同时,能力表显示服务器可直接删除卡片、清单项等(不同于可撤销的归档),但文档中没有提到任何二次确认或权限范围限制机制。这些风险是可见的但未被充分缓解,不构成红线级问题(无恶意代码、无隐蔽外泄、无虚假身份证据),故评为 8 分。
维护活跃度 7/20: 仓库有 55 星、7 个未关闭 issue,未被归档,说明项目仍存在一定关注度。但许可证状态为“unknown”,README 中也未说明版本发布节奏、变更日志、依赖升级策略或安全响应渠道,治理和版本化方面证据严重不足。许可证不明确会带来法律使用风险,故评为较低的 7 分。
文档质量 14/20: README 结构完整,包含前置条件、安装步骤、多种运行模式（Claude App/SSE/Docker）、配置项表格、多客户端集成说明、能力矩阵、使用示例及故障排查章节,整体可用性较好。但缺少各工具的具体输入/输出参数模式（schema）、速率限制、成本影响、以及针对写入/删除类操作的风险提示,这些是评为满分的障碍,故评为 14 分。
安装易用性 12/20: 安装流程步骤明确（创建 Trello Power-Up 获取 API Key/Token、重命名 .env.example、安装 uv、克隆仓库、运行 uv run mcp install main.py、重启 Claude),并提供了 Docker Compose 备选方案,具备多步骤但可跟随的特点。由于是纯静态审查,没有实际执行验证安装是否真正顺利完成,且步骤涉及外部平台手动操作（申请 Trello 凭据）,按规则静态评审 setup 不得超过 15 分,综合流程的复杂度与不确定性评为 12 分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已经在使用 Trello 进行任务管理、希望通过 Claude 或 Cursor 以对话方式操作卡片和列表的个人或团队
需要在 Claude Desktop 或支持 SSE 的 MCP 客户端中快速接入 Trello 的开发者

不适合谁

需要创建、重命名或删除整个看板的用户（该操作未被支持）
没有 Trello API Key/Token 或无法访问 Trello Power-Up 管理页面的用户
需要官方 Trello/Atlassian 支持或企业级安全审计的场景

所需权限

Trello API Key 和 Token（账号级别权限，可读写该账号可访问的看板、列表、卡片和检查清单）
本地 .env 文件中以明文形式存储的凭据
网络访问权限：调用 Trello API，以及（SSE 模式下）在本机开放 HTTP 服务端口

风险与副作用

API Key 和 Token 以明文保存在 .env 文件中，一旦泄露即可完全操控你的 Trello 账号
列表、卡片、检查清单及子项的删除/归档操作不可逆
SSE 模式下会在本地开放 HTTP 端点，README 未提及内置身份验证机制
该项目为社区维护的第三方服务器，未经 Trello/Atlassian 官方审核或背书

安装接入

准备工作

运行环境：Python 3.12+ · Docker

TRELLO_API_KEY 必填密钥 Trello API 密钥，在 Trello Power-Up 管理页创建应用后获取。

TRELLO_TOKEN 必填密钥 Trello API 令牌，在 API key 页面手动生成。

其他可选配置项（4 个）

MCP_SERVER_NAME 可选 MCP 服务器名称，默认 Trello MCP Server。

MCP_SERVER_HOST 可选 SSE 模式监听地址，默认 0.0.0.0。

MCP_SERVER_PORT 可选 SSE 模式监听端口，默认 8000。

USE_CLAUDE_APP 可选是否使用 Claude 应用模式，默认 true。

在 Trello 的 Power-Up 管理页面创建一个新的 Integration，获取 API Key 和 Token
将仓库中的 .env.example 重命名为 .env，并填入 TRELLO_API_KEY 与 TRELLO_TOKEN
安装 uv 包管理器
克隆仓库 m0xai/trello-mcp-server
运行 uv run mcp install main.py 将服务器安装到 Claude Desktop（默认 Claude App 模式），或将 .env 中的 USE_CLAUDE_APP 设为 false 后运行 python main.py 以 SSE 模式启动（默认监听 localhost:8000）
也可使用 docker-compose up -d 以容器方式运行（默认使用 SSE 模式）
重启 Claude Desktop 或在 Cursor 中添加 SSE 服务器地址完成连接。

claude_desktop_config.json

{"mcpServers": {"trello": {"url": "http://localhost:8000/sse"}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "trello": {
      "url": "http://localhost:8000/sse"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http trello http://localhost:8000/sse

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 或 Cursor 中连接后询问"Show me all my boards"，若能返回你的 Trello 看板列表则说明安装成功。

常见排障

确认 .env 文件中的 TRELLO_API_KEY 和 TRELLO_TOKEN 是否正确
检查你在对应 Trello 工作区中是否拥有足够权限
确保 Claude Desktop 已更新到最新版本
使用 `uv run mcp dev main.py` 查看运行日志排查错误
确认 uv 已正确安装并加入系统 PATH

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的所有 Trello 看板
看板 Guitar 里有哪些列表？
在列表里创建一张新卡片，标题为……
把列表归档

使用场景

让 Claude 列出并查看你的 Trello 看板、列表和卡片详情

通过自然语言创建、更新或删除 Trello 卡片

为卡片添加、更新或删除检查清单及其子项

创建、重命名或归档（删除）Trello 列表

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Trello MCP Server 是一个基于 Python 的第三方 MCP 服务器，让 AI 客户端可以读取 Trello 看板，并对列表、卡片、检查清单（checklist）及其子项进行创建、更新和删除操作。看板本身仅支持读取，不支持创建、修改或删除。服务器支持两种运行模式：与 Claude 桌面版直接集成的 'Claude App 模式'，以及可供 Cursor 等任意兼容 MCP 客户端使用的独立 SSE 服务器模式，同时也提供 Docker Compose 部署方式。