MCP Server Trello

Name: MCP Server Trello
Author: delorenj

Read and manage Trello boards, lists, cards, checklists and comments from an MCP client

By delorenj (individual) TypeScript Local · stdio Productivity

GitHub npm Website

64 popularity score ★ 447 ↓ 5.4k/wk

Connect your client

Local (npm)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

It needs TRELLO_API_KEY, TRELLO_TOKEN. Replace each <NAME> with your value.

Claude CodeTerminal

claude mcp add trello -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> -- npx -y @delorenj/mcp-server-trello

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": [
        "-y",
        "@delorenj/mcp-server-trello"
      ],
      "env": {
        "TRELLO_API_KEY": "<TRELLO_API_KEY>",
        "TRELLO_TOKEN": "<TRELLO_TOKEN>"
      }
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": [
        "-y",
        "@delorenj/mcp-server-trello"
      ],
      "env": {
        "TRELLO_API_KEY": "<TRELLO_API_KEY>",
        "TRELLO_TOKEN": "<TRELLO_TOKEN>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "trello": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@delorenj/mcp-server-trello"
      ],
      "env": {
        "TRELLO_API_KEY": "<TRELLO_API_KEY>",
        "TRELLO_TOKEN": "<TRELLO_TOKEN>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.trello]
command = "npx"
args = ["-y", "@delorenj/mcp-server-trello"]

[mcp_servers.trello.env]
TRELLO_API_KEY = "<TRELLO_API_KEY>"
TRELLO_TOKEN = "<TRELLO_TOKEN>"

Gemini CLITerminal

gemini mcp add --scope user -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> trello npx -- -y @delorenj/mcp-server-trello

Settings 6

`TRELLO_API_KEY`	Required: Trello API key from trello.com/app-key; the server exits at start without it.
`TRELLO_TOKEN`	Required: Trello token generated with that key; the server exits at start without it.
`TRELLO_WORKSPACE_ID`	Optional: Initial active workspace; can be changed with set_active_workspace.
`TRELLO_BOARD_ID`	Optional: Deprecated: initial default board; use set_active_board instead.
`TRELLO_ALLOWED_WORKSPACES`	Optional: Comma-separated workspace IDs; when set, other workspaces are hidden or refused.
`https_proxy`	Optional: Proxy URL for Trello API requests (HTTPS_PROXY also works).

What it does

MCP Server Trello is a community-built server that runs on your own machine. It talks to the Trello REST API with your API key and token, so an assistant can work with your Trello boards: read lists and cards, create and move cards, edit lists, manage checklists, labels, members, comments and custom fields, attach files, and create boards.

It keeps an active board and workspace that tools fall back to when no boardId is passed. You can switch them with set_active_board and set_active_workspace without restarting, and the choice is saved in ~/.trello-mcp/config.json. Requests are throttled to stay within Trello's limits of 300 requests per 10 seconds per key and 100 per 10 seconds per token.

A few tools go beyond plain API calls. get_acceptance_criteria pulls a card's acceptance-criteria checklist, find_checklist_items_by_description searches checklist items by text, and add_cards_to_list creates many cards in one call, one after another. The v1.8.1 source registers 57 tools in all. That count includes five health tools and perform_system_repair, which report on the server's own connection and state. The README's tool reference covers fewer than that and leaves out the health tools, copy_card, the label and member tools, and others.

What it needs

Runtime	Node.js

Node.js (npx) or Bun (bunx); the published build starts with node, so Node is enough. A Trello account, plus an API key and token generated at trello.com/app-key, set as TRELLO_API_KEY and TRELLO_TOKEN.

Limits

Talks to the Trello API with one key and token; it cannot reach anything the token cannot. Cards and lists are archived, not deleted; the source has no tool to delete a card, list or board. Files are attached from a URL or from base64 data; no tool reads a path on your disk. add_cards_to_list creates cards one by one because Trello has no batch write. get_recent_activity returns 10 actions by default. TRELLO_BOARD_ID is marked deprecated in favour of set_active_board. Its docs give bunx in their examples; npx works the same.

Who it suits

Suits someone who wants an assistant to read and change their own Trello boards from a local client, with a key and token they control, and who wants checklist-heavy workflows such as acceptance criteria on cards. TRELLO_ALLOWED_WORKSPACES limits it to chosen workspaces. If you would rather not handle a long-lived token, or want a hosted connector for ChatGPT or Claude, Atlassian's own Trello MCP Server (which we also list) runs in Atlassian's cloud and signs in with OAuth instead.

Tools 57

get_cards_by_list_id: Lists the cards in one list.
get_lists: Lists the lists on a board.
get_recent_activity: Fetches recent actions on a board.
add_card_to_list: Creates a card in a list.
update_card_details: Changes a card's name, description, dates or labels.
archive_card: Archives a card.
watch_card: Subscribes you to a card's activity.
watch_list: Subscribes you to a list's activity.
move_card: Moves a card to another list or board.
add_list_to_board: Creates a list on a board.
archive_list: Archives a list.
update_list: Renames or otherwise edits a list.
update_list_position: Reorders a list on its board.
get_my_cards: Lists cards assigned to you.
attach_image_to_card: Attaches an image from a URL to a card.
attach_file_to_card: Attaches any file from a URL to a card.
attach_data_to_card: Attaches base64 or data-URL content to a card.
attach_image_data_to_card: Attaches a base64 image, PNG by default, to a card.
list_boards: Lists boards you can access.
set_active_board: Sets the default board for later calls.
list_workspaces: Lists your workspaces.
create_board: Creates a board, optionally in a workspace.
set_active_workspace: Sets the default workspace.
list_boards_in_workspace: Lists the boards in one workspace.
get_active_board_info: Shows details of the current default board.
get_card: Fetches a card with checklists, attachments, labels, members and comments.
add_comment: Posts a comment on a card.
update_comment: Edits a comment.
delete_comment: Deletes a comment.
get_card_comments: Lists a card's comments.
create_checklist: Adds a checklist to a card.
get_checklist_items: Lists the items of a named checklist.
add_checklist_item: Adds an item to a checklist.
find_checklist_items_by_description: Searches checklist items by text.
get_acceptance_criteria: Reads a card's acceptance-criteria checklist.
get_checklist_by_name: Fetches a checklist with its completion percentage.
update_checklist_item: Changes a checklist item's text or state.
delete_checklist_item: Removes a checklist item.
get_board_members: Lists a board's members.
assign_member_to_card: Adds a member to a card.
remove_member_from_card: Removes a member from a card.
get_board_labels: Lists a board's labels.
create_label: Creates a label on a board.
update_label: Renames or recolours a label.
delete_label: Deletes a label.
copy_card: Duplicates a card into any list, even on another board.
copy_checklist: Copies a checklist to another card.
add_cards_to_list: Creates several cards in a list in one call.
get_board_custom_fields: Lists a board's custom field definitions.
update_card_custom_field: Sets a custom field value on a card.
get_card_history: Lists the actions taken on a card.
download_attachment: Returns a card attachment as base64 data.
get_health: Reports basic server and API health.
get_health_detailed: Gives a detailed health diagnosis.
get_health_metadata: Checks the active board's data for consistency.
get_health_performance: Reports request and rate-limit performance.
perform_system_repair: Tries to fix problems found by the health check.

Popularity

64 popularity score, on our list (the bar is 36)

★ 447 ↓ 5.4k/wk

GitHub stars	447	31.8 points
Stars in 30 days	+2	2.4 points
npm downloads, last week	5,378	29.8 points

Measured 2026-11-07. How the score works.

Where it is published

Code	delorenj/mcp-server-trello ★ 447
npm	@delorenj/mcp-server-trello 1.8.1, 2026-07-25

What it can reach

Runs	On your machine
Reaches	Your account at a service, The internet
Changes things	Yes: it can write, send, create or delete
Sign-in	An API key or token
Licence	MIT (npm)
Last code change	2026-10-15

Runs on your machine over stdio and calls the Trello API with your API key and token, so it can reach every board and workspace that token can, unless TRELLO_ALLOWED_WORKSPACES narrows the workspaces. Tools write: they create boards, lists, cards, labels and comments, move, copy and archive cards and lists, assign members, and delete comments, labels and checklist items. Attachment tools fetch files from a URL you give or take base64 data, and download_attachment returns file contents. It saves the active board and workspace in ~/.trello-mcp/config.json. It is a community project, not published by Atlassian.

Over time

GitHub stars 447 +2

448445

9 Oct 20267 Nov 2026

npm downloads a week 5.4k +4.4k (+457 %)

114k150

20 Oct 20257 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 64 +4 (+7 %)

6458

9 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-14.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![MCP Server Trello on EveryMCPServer](https://everymcpserver.com/badge/mcp-server-trello.svg)](https://everymcpserver.com/servers/mcp-server-trello)

Connect your client

Add in one click

Or add it by command or config

Settings 6

What it does

What it needs

Limits

Who it suits

Tools 57

Similar servers

Mindwtr MCP Server

Todoist MCP

Box MCP server

MCP Linear

Contentful MCP Server

ClickUp MCP Server