mcp-server-trello — Claude Code MCP server: setup and tools
MCP server connecting AI agents to Trello boards, cards, checklists, and comments. Handles rate limits and acceptance criteria extraction.
claude mcp add mcp-server-trello -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> -- npx -y @delorenj/mcp-server-trelloWhat mcp-server-trello does
This server exposes 57 tools to inspect and mutate Trello entities. Agents can read card details, manage comments, add URL-based attachments, and export data formatted as Markdown. A dedicated get_acceptance_criteria tool pulls acceptance criteria checklists directly into the model context.
Written in TypeScript and built on Bun, the package executes via bunx or npx. It automatically respects Trello API rate limits of 300 requests per 10 seconds per key and 100 requests per 10 seconds per token. Both TRELLO_API_KEY and TRELLO_TOKEN are required in the environment before startup.
Workspaces and boards switch dynamically during agent runs with set_active_board and set_active_workspace. Configuration restarts are not needed. Corporate proxy routing is supported through https_proxy.
What it helps with
- fetch acceptance criteria checklists directly into agent context
- export complete card contents including comments and attachments to Markdown
- create, reorder, and archive lists on active Trello boards
- track board updates by watching cards and lists with
watch_card
Example prompts for the agent
- Get acceptance criteria checklist for card
CARD_IDin Trello. - Create a new list named 'Ready for Review' and move it to position 2.
- Export all comments and attachments for card
TASK-12in Markdown format.
How to install mcp-server-trello
Platform CLI
claude mcp add mcp-server-trello -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> -- npx -y @delorenj/mcp-server-trelloReplace <…> with your own values
Platform CLI
codex mcp add mcp-server-trello --env TRELLO_API_KEY=<TRELLO_API_KEY> --env TRELLO_TOKEN=<TRELLO_TOKEN> -- npx -y @delorenj/mcp-server-trelloReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server-trello": {
"command": "npx",
"args": [
"-y",
"@delorenj/mcp-server-trello"
],
"env": {
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server-trello": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@delorenj/mcp-server-trello"
],
"env": {
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> mcp-server-trello npx -y @delorenj/mcp-server-trelloReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server-trello
How do I install mcp-server-trello in Claude Code?
Run claude mcp add mcp-server-trello -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> -- npx -y @delorenj/mcp-server-trello. Obtain the API key and generate a token at trello.com/app-key.
What does mcp-server-trello do?
It provides 57 tools for reading and managing Trello cards, checklists, lists, custom fields, and comments with automatic API rate limiting.
Can mcp-server-trello switch boards without restarting?
Yes, tools like set_active_board and set_active_workspace let the agent change active boards and workspaces dynamically during a session.
