# trello-mcp

> trello-mcp is an open-source MCP server for productivity. Self-hosted community MCP server for Trello boards, cards and checklists. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, API, CLI
- **Website:** https://trello-mcp.com
- **Repository:** https://github.com/enthouan/trello-mcp
- **MCP Registry name:** io.github.enthouan/trello-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/trello-mcp
