trello-mcp
Self-hosted community MCP server for Trello boards, cards and checklists
- Pricing
- Open source
- Platforms
- self-hosted, API, CLI
- Runs
- Locally
- Version
- 1.0.5
- Listing updated
- 2 days ago
About trello-mcp
trello-mcp is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
This is an independent project, not a Trello or Atlassian product, and the maintainers say so prominently. Its site describes 77 catalogue-backed tools generated from the server's own runtime definitions, covering boards, lists, cards, checklists, labels, members, comments, attachments, custom fields and search.
It is built to be run by you. You can use local stdio with no network listener, or the documented Docker Compose setup that publishes Streamable HTTP on loopback; wider HTTP access is meant to be deliberate and can be protected with a separate MCP_AUTH_TOKEN. Trello credentials come from the TRELLO_API_KEY and TRELLO_TOKEN environment variables and are not placed in prompts.
Write safety is a stated design point: cards and lists have archive controls, and permanent card and label deletion is marked explicit-only in the tool guidance, with MCP client approval as the enforcement boundary. A read-only auth_whoami tool confirms which Trello account is connected.
Install
Run in a terminal
claude mcp add trello-mcp --env TRELLO_API_KEY='<TRELLO_API_KEY>' --env TRELLO_TOKEN='<TRELLO_TOKEN>' -- docker run -i --rm -e TRELLO_API_KEY -e TRELLO_TOKEN ghcr.io/enthouan/trello-mcp:1.0.5Add to claude_desktop_config.json
{
"mcpServers": {
"trello-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRELLO_API_KEY",
"-e",
"TRELLO_TOKEN",
"ghcr.io/enthouan/trello-mcp:1.0.5"
],
"env": {
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"trello-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRELLO_API_KEY",
"-e",
"TRELLO_TOKEN",
"ghcr.io/enthouan/trello-mcp:1.0.5"
],
"env": {
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"trello-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRELLO_API_KEY",
"-e",
"TRELLO_TOKEN",
"ghcr.io/enthouan/trello-mcp:1.0.5"
],
"env": {
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"trello-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRELLO_API_KEY",
"-e",
"TRELLO_TOKEN",
"ghcr.io/enthouan/trello-mcp:1.0.5"
],
"env": {
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"trello-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRELLO_API_KEY",
"-e",
"TRELLO_TOKEN",
"ghcr.io/enthouan/trello-mcp:1.0.5"
],
"env": {
"TRELLO_API_KEY": "<TRELLO_API_KEY>",
"TRELLO_TOKEN": "<TRELLO_TOKEN>"
}
}
}
}Configuration
TRANSPORTRun the container as an MCP stdio server.TRELLO_API_KEYYour Trello API key from https://trello.com/power-ups/admin.RequiredTRELLO_TOKENYour Trello API token authorizing access to your boards.Required
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- list_boards
- Lists boards visible to the connected Trello member.
- board_lists
- Lists the lists on a board.
- card_create
- Creates a card in a list.
- card_move
- Moves a card between lists or boards.
- card_archive
- Archives a card reversibly.
- card_get
- Reads a card.
- card_actions
- Reads a card's activity history.
- card_members
- Lists the members on a card.
- card_member_add
- Adds a member to a card.
- card_comment_add
- Adds a comment to a card.
- card_checklists
- Lists a card's checklists.
- card_checklist_item_create
- Adds an item to a checklist.
- card_custom_field_set
- Sets a custom field value on a card.
- search
- Searches Trello cards, boards, members and workspaces.
- auth_whoami
- Confirms the connected Trello account.
What it does
- Wide Trello coverage
- 77 tools across boards, lists, cards, checklists, labels, members, comments, attachments and custom fields.
- Search and activity
- Search cards, boards, members and workspaces, and read card activity history.
- Archive before delete
- Cards and lists can be archived reversibly; permanent deletion is flagged as explicit-only.
- Local or containerised
- Runs over stdio or as a Docker image with Streamable HTTP on loopback.
- Secrets stay in the environment
- API key and token are read from environment variables, not from prompts.
- Searchable tool catalogue
- The site lists every tool with filters by category and behaviour.
Good for
- Create a card in a chosen list from a chat
- Summarise a card and its recent activity
- Assign collaborators and add a comment
- Add checklist items and set custom fields
- Keep a project roadmap board up to date
Pricing
Open source
Prices change. Check trello-mcp.com before you buy.
trello-mcp FAQ
Is this the official Trello MCP server?
No. It is community-maintained and not affiliated with Trello or Atlassian; Trello's own hosted server is a separate product.
What credentials does it need?
A Trello API key and token, passed as TRELLO_API_KEY and TRELLO_TOKEN.
How do I run it?
As a container from GHCR over stdio, or with Docker Compose using Streamable HTTP published to loopback.
Can it delete cards?
Yes, but permanent deletion is meant to happen only on explicit request; archiving is the reversible alternative.
Is trello-mcp free?
Yes. trello-mcp is open source, so you can use and self-host it for free.
How do I add trello-mcp to Claude Code?
Run this command in your terminal: claude mcp add trello-mcp --env TRELLO_API_KEY='<TRELLO_API_KEY>' --env TRELLO_TOKEN='<TRELLO_TOKEN>' -- docker run -i --rm -e TRELLO_API_KEY -e TRELLO_TOKEN ghcr.io/enthouan/trello-mcp:1.0.5
What are the best alternatives to trello-mcp?
The closest alternatives to trello-mcp are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to trello-mcp

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media