trello-mcp — Claude Code MCP server: what it does, how to install
Connects coding assistants to Trello boards, cards, and checklists. Useful for managing project tasks directly inside your AI workflow.
claude mcp add --env TRANSPORT=<TRANSPORT> --env TRELLO_API_KEY=<TRELLO_API_KEY> --env TRELLO_TOKEN=<TRELLO_TOKEN> --transport stdio trello-mcp -- docker run -i --rm -e TRANSPORT -e TRELLO_API_KEY -e TRELLO_TOKEN ghcr.io/enthouan/trello-mcp:1.0.4What trello-mcp does
This community MCP server links client tools to Trello via its REST API. It handles board discovery, workspace inspection, and list organization. Inputs and API responses pass through Zod schemas, while logs keep stdout clean by directing debug information to stderr.
An assistant can build new cards, assign members, update due dates, and manage checklists. The server also supports uploading local files from a configured path and searching boards with native search operators. Note that a running Docker engine and personal credentials (TRELLO_API_KEY and TRELLO_TOKEN) are strictly required before setup.
What it helps with
- inspect boards and move tasks across lists
- create cards with due dates, labels, and member assignments
- read and modify checklist items on existing cards
- query workspaces and boards using native search operators
Example prompts for the agent
- List all open tasks on the Sprint board
- Add a testing checklist to the authentication card
- Move the bugfix card to Done and post a summary comment
How to install trello-mcp
Platform CLI
claude mcp add --env TRANSPORT=<TRANSPORT> --env TRELLO_API_KEY=<TRELLO_API_KEY> --env TRELLO_TOKEN=<TRELLO_TOKEN> --transport stdio trello-mcp -- docker run -i --rm -e TRANSPORT -e TRELLO_API_KEY -e TRELLO_TOKEN ghcr.io/enthouan/trello-mcp:1.0.4Replace <…> with your own values
Platform CLI
codex mcp add trello-mcp --env TRANSPORT=<TRANSPORT> --env TRELLO_API_KEY=<TRELLO_API_KEY> --env TRELLO_TOKEN=<TRELLO_TOKEN> -- docker run -i --rm -e TRANSPORT -e TRELLO_API_KEY -e TRELLO_TOKEN ghcr.io/enthouan/trello-mcp:1.0.4Replace <…> with your own values
Config file
{
"mcpServers": {
"trello-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRANSPORT",
"-e",
"TRELLO_API_KEY",
"-e",
"TRELLO_TOKEN",
"ghcr.io/enthouan/trello-mcp:1.0.4"
],
"env": {
"TRANSPORT": "<TRANSPORT>",
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"trello-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRANSPORT",
"-e",
"TRELLO_API_KEY",
"-e",
"TRELLO_TOKEN",
"ghcr.io/enthouan/trello-mcp:1.0.4"
],
"env": {
"TRANSPORT": "<TRANSPORT>",
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TRANSPORT=<TRANSPORT> -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> trello-mcp docker run -i --rm -e TRANSPORT -e TRELLO_API_KEY -e TRELLO_TOKEN ghcr.io/enthouan/trello-mcp:1.0.4Replace <…> 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 trello-mcp
How do I install trello-mcp in Claude Code?
Run `claude mcp add --env TRANSPORT=<TRANSPORT> --env TRELLO_API_KEY=<TRELLO_API_KEY> --env TRELLO_TOKEN=<TRELLO_TOKEN> --transport stdio trello-mcp -- docker run -i --rm -e TRANSPORT -e TRELLO_API_KEY -e TRELLO_TOKEN ghcr.io/enthouan/trello-mcp:1.0.4`. Ensure Docker is running locally.
What does trello-mcp do?
It connects MCP-compatible tools to Trello using your API tokens. Your assistant can browse workspaces, create cards, update deadlines, and post comments without opening a browser.
How are Trello credentials obtained?
Create an app in the admin portal at trello.com/apps/admin to generate your API key. From that page, authorize access through the token link to receive your user token.
