Claude MCP Trello MCP Server

A Model Context Protocol (MCP) server for interacting with Trello boards

Local serverstdioTypeScript

What is the Claude MCP Trello MCP server?

Claude mcp trello mcp server connects Claude MCP Trello to AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server for interacting with Trello boards.

What Claude MCP Trello does

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello's API while handling rate limiting, type safety, and error handling automatically.

Key capabilities

  • Full Trello Board Integration — Interact with cards, lists, and board activities
  • Built-in Rate Limiting — Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token)
  • Type-Safe Implementation — Written in TypeScript with comprehensive type definitions
  • Input Validation — Robust validation for all API inputs
  • Error Handling — Graceful error handling with informative messages

Tools it exposes

Once connected, the assistant can call these 14 tools directly:

  • trello_get_cards_by_list — Retrieves a list of cards contained in the specified list ID
  • trello_get_lists — The trello_get_lists tool exposed by this server
  • trello_get_recent_activity — Retrieves the most recent activity for a specified board. The limit argument can specify how many to retrieve (default: 10)
  • trello_add_card — The trello_add_card tool exposed by this server
  • trello_update_card — The trello_update_card tool exposed by this server
  • trello_archive_card — The trello_archive_card tool exposed by this server
  • trello_add_list — The trello_add_list tool exposed by this server
  • trello_archive_list — The trello_archive_list tool exposed by this server
  • trello_get_my_cards — The trello_get_my_cards tool exposed by this server
  • trello_search_all_boards — Performs a cross-board search across all boards in the workspace (organization), depending on plan/permissions
  • trello_get_card_attachments — Retrieves all attachments from a specified card. Returns attachment metadata including name, file size, MIME type, and URL. Use this to discover what
  • trello_download_attachment — Downloads a specific attachment from a Trello card. For files uploaded directly to Trello, returns the content as base64-encoded data. For external links
  • Prerequisites — The Prerequisites tool exposed by this server
  • Setup — 1. Clone the repository: bash git clone https://github.com/hrs-asano/claude-mcp-trello.git cd claude-mcp-trello

Installing the claude mcp trello mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 6 environment variables: TRELLO_API_KEY, TRELLO_TOKEN, YOUR_NODE_PATH, YOUR_PATH, YOUR_KEY, YOUR_TOKEN. Keep credentials in your client's env block or a secrets manager rather than committing them.

Requirements

  • Node.js 16 or higher - npm or yarn

Where it fits

Productivity servers pay off through capture: the tasks and notes that never get filed are the ones where opening the app is more friction than the thought is worth. Claude MCP Trello sits in that group, and the shape of its toolset — trello_get_cards_by_list, trello_get_lists, trello_get_recent_activity among others — tells you what it is really for. Worth comparing against the other productivity servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • With 14 tools exposed, expect a noticeable bump in prompt size — disable it in projects that never use Claude MCP Trello.
  • Maintained by hrs-asano, written in TypeScript.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the claude mcp trello mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
trello_get_cards_by_listRetrieves a list of cards contained in the specified list ID.
trello_get_listsThe trello_get_lists tool exposed by this server.
trello_get_recent_activityRetrieves the most recent activity for a specified board. The limit argument can specify how many to retrieve (default: 10).
trello_add_cardThe trello_add_card tool exposed by this server.
trello_update_cardThe trello_update_card tool exposed by this server.
trello_archive_cardThe trello_archive_card tool exposed by this server.
trello_add_listThe trello_add_list tool exposed by this server.
trello_archive_listThe trello_archive_list tool exposed by this server.
trello_get_my_cardsThe trello_get_my_cards tool exposed by this server.
trello_search_all_boardsPerforms a cross-board search across all boards in the workspace (organization), depending on plan/permissions.
trello_get_card_attachmentsRetrieves all attachments from a specified card. Returns attachment metadata including name, file size, MIME type, and URL. Use this to discover what attachments exist on a card before downloading.
trello_download_attachmentDownloads a specific attachment from a Trello card. For files uploaded directly to Trello, returns the content as base64-encoded data. For external links, returns the URL.
PrerequisitesThe Prerequisites tool exposed by this server.
Setup1. Clone the repository: bash git clone https://github.com/hrs-asano/claude-mcp-trello.git cd claude-mcp-trello

How to install the Claude MCP Trello MCP server

{
    "mcpServers": {
      "trello": {
        "command": "{YOUR_NODE_PATH}", // for example: /opt/homebrew/bin/node
        "args": [
          "{YOUR_PATH}/claude-mcp-trello/build/index.js"
        ],
        "env": {
          "TRELLO_API_KEY": "{YOUR_KEY}",
          "TRELLO_TOKEN": "{YOUR_TOKEN}"
        }
      }
    }
  }

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 16 or higher - npm or yarn
VariableDescriptionRequired
TRELLO_API_KEYCredential the server authenticates with.Yes
TRELLO_TOKENCredential the server authenticates with.Yes
YOUR_NODE_PATHFilesystem location the server is allowed to use.Optional
YOUR_PATHFilesystem location the server is allowed to use.Optional
YOUR_KEYCredential the server authenticates with.Yes
YOUR_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Claude MCP Trello to trello get cards by list.
  • Use Claude MCP Trello to trello get lists.
  • Use Claude MCP Trello to trello get recent activity.

Frequently asked questions

It connects Claude MCP Trello to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (trello_get_cards_by_list, trello_get_lists, trello_get_recent_activity, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Claude MCP Trello directly.