Skip to content
MCP server

trello-mcp

Self-hosted community MCP server for Trello boards, cards and checklists

Runs locallyStatus and history
Install
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.5

Add 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.Required
  • TRELLO_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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media