Skip to main content
Glama

trello-mcp

A small Model Context Protocol server for Trello. It lets Claude Code (or any MCP client) read the cards a customer writes for you, tick checklist items and leave comments, without leaving the editor.

Built for a real workflow: the product owner on my current project files every round of feedback as a Trello card with a checklist. With this server the assistant reads the card, works through the items and ticks them off as each one lands.

Tools

Tool

What it does

trello_list_boards

Open boards for the token's user

trello_list_lists

Lists (columns) on a board

trello_list_cards

Open cards on a board or in one list

trello_get_card

Full card: description, checklists with item ids and states, members, labels, attachments, comments

trello_search_cards

Trello search across boards (board:X is:open @me label:bug)

trello_set_checklist_item

Tick / untick a checklist item

trello_add_comment

Post a comment on a card

trello_move_card

Move a card to another list

Card arguments accept an id, a short link, or the full card URL, so you can paste a link straight from Trello. Read tools are annotated readOnlyHint: true; the three write tools are not, so clients can ask before running them.

Related MCP server: Trello MCP server

Setup

  1. Get an API key and token: https://trello.com/power-ups/admin → your Power-Up → API key → "Token".

  2. Build:

npm install
npm run build
  1. Register with Claude Code (user scope, so it works in every project):

claude mcp add trello --scope user \
  -e TRELLO_API_KEY=your_key -e TRELLO_TOKEN=your_token \
  -- node /absolute/path/to/trello-mcp/dist/index.js

Or by hand in ~/.claude.json:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-mcp/dist/index.js"],
      "env": { "TRELLO_API_KEY": "your_key", "TRELLO_TOKEN": "your_token" }
    }
  }
}

Development

npm test          # vitest, no network: the Trello client takes an injected fetch
npm run typecheck
npm run dev       # runs the server over stdio with tsx

The code is split so the interesting parts are testable without a server:

  • src/trello.ts — typed client over the REST API, URL/short-link parsing, error mapping

  • src/format.ts — renders cards as compact markdown for the model (ids stay visible for follow-up calls)

  • src/tools.ts — tool definitions with zod input schemas and handlers

  • src/index.ts — MCP wiring over stdio

Notes

  • Everything runs as the token's user: comments and ticks show up under your name in Trello.

  • stdout is the MCP channel; the server writes diagnostics to stderr only.

  • Trello rate limits: 300 requests per 10 s per key, 100 per 10 s per token. Normal use is far below that.

Available Tools

8 tools
trello_add_commentAdd commentB

Post a comment on a card as the token's user.

Inputs: text (required), cardId (required).

trello_get_cardGet cardA
Read-only

Full card: description, checklists with item ids and states, members, labels, attachments and comments.

Inputs: cardId (required).

trello_list_boardsList boardsA
Read-only

List the open boards the current user can see, with ids for the other tools.

Inputs: no named parameters.

trello_list_cardsList cardsA
Read-only

List open cards on a board or in one list. Pass listId to narrow to a column, otherwise boardId for the whole board.

Inputs: listId, boardId.

trello_list_listsList lists on a boardB
Read-only

List the open lists (columns) of a board.

Inputs: boardId (required).

trello_move_cardMove cardA

Move a card to another list on the same board. List ids come from trello_list_lists.

Inputs: cardId (required), listId (required).

trello_search_cardsSearch cardsA
Read-only

Search cards across all boards. Supports Trello search operators, e.g. 'board:Project is:open @me label:bug'.

Inputs: query (required), limit.

trello_set_checklist_itemTick or untick a checklist itemA

Mark a checklist item complete or incomplete. Item ids come from trello_get_card.

Inputs: state (required), cardId (required), checkItemId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: boards, lists, cards, comments, moves, search, and checklist items. list_cards and search_cards could superficially overlap, but the descriptions clearly distinguish browsing a board/list from global search.

    Naming Consistency5/5

    All tools use a consistent trello_ prefix followed by a verb_noun pattern, such as trello_list_boards and trello_move_card. There are no deviations in casing or verb style.

    Tool Count5/5

    Eight tools are well-scoped for a focused Trello workflow covering discovery, card inspection, search, comments, moves, and checklist updates. Each tool has a clear role without excessive surface area.

    Completeness2/5

    The set supports reading and some card actions but lacks fundamental Trello operations such as creating cards, creating lists, updating card fields, and archiving/deleting items. These gaps will block common agent workflows despite the solid read/search/move coverage.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers