mcp-server-trello 0.2.1

MCP server for Trello API integration

MCP Server for Trello

Agent-native Model Context Protocol server for using Trello as a project-management backend for LLM agents.

The server exposes compact workflow tools first, with guarded raw Trello calls available only as escape hatches.

Tool Surface

The revised MCP exposes 24 current tools. Prefer compact grouped tools before raw Trello calls.

Board discovery and read tools:

• open_board
• get_board_snapshot
• find_cards
• get_card_context
• get_board_activity

Card mutation tools:

• create_cards
• update_cards
• move_cards
• label_cards
• comment_on_card

Grouped project-management tools:

• manage_boards
• manage_cards
• manage_comments
• manage_checklists
• manage_attachments
• manage_custom_fields
• assign_members
• manage_lists
• manage_labels
• batch_get_compact

Raw guarded escape hatches:

• trello_get
• trello_post
• trello_put
• trello_delete

Raw tools are for cases the compact surface cannot express. They reject unsafe endpoints, credential-bearing URLs, and unconfirmed deletes.

Response Shape

Tools return compact dict envelopes:

{
  "ok": true,
  "tool": "open_board",
  "board": {"id": "...", "name": "...", "url": "..."},
  "result": {},
  "warnings": [],
  "errors": []
}

Errors and warnings use stable machine-readable codes so agents can recover or retry safely.

Board Maps

open_board refreshes a local board map so agents can resolve board-local list and label aliases without rediscovering IDs each turn.

Default storage:

~/.config/mcp-server-trello/boards

Override storage with:

TRELLO_MCP_BOARD_MAP_DIR=/path/to/boards

Board maps store board/list/label metadata and aliases. They do not store card contents, comments, or credentials.

Example Workflows

Open a board:

open_board(name_or_id="Suitepath")

Create cards in bulk:

create_cards(board_id_or_name="Suitepath", list="TODO", cards=[{"name": "Draft release notes"}])

Label cards in bulk:

label_cards(board_id_or_name="Suitepath", card_refs=["Draft release notes"], add=["Feature"])

Inspect recent activity:

get_board_activity(board_id_or_name="Suitepath", limit=10)

Run a compact batch read:

batch_get_compact(urls=["/boards/board_id/cards", "/boards/board_id/labels"])

Installation

uvx mcp-server-trello

Required runtime environment:

• TRELLO_API_KEY
• TRELLO_API_TOKEN

Deployment

See DEPLOYMENT.md for the release and PyPI publish flow.