MCP Directory

Trello MCP

Comprehensive Trello integration for Claude Desktop, Claude Code, Gemini CLI and other MCP clients — 19 tools for boards, cards and lists.

Unverified
stdio (local)
API key
TypeScript

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
git clone https://github.com/kocakli/trello-desktop-mcp.git && cd trello-desktop-mcp && npm install && npm run build

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "trello-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/trello-desktop-mcp/dist/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

  • Node.js 18+ installed
  • An MCP-compatible client (Claude Desktop, Claude Code, Gemini CLI, etc.)
  • A Trello account with API credentials (API Key and Token from https://trello.com/app-key)

About Trello MCP

A Model Context Protocol server that connects AI assistants to Trello, enabling natural-language management of boards, lists, cards, comments, members, labels, checklists and attachments. It runs locally over stdio and works with Claude Desktop, Claude Code, Gemini CLI and any other stdio-compatible MCP client, exposing 19 tools backed by the Trello REST API with built-in error handling and rate-limit retry logic.

Tools & capabilities (19)

trello_search

Universal search across all Trello content (boards, cards, members, organizations).

trello_get_user_boards

Get all boards accessible to the current user.

get_board_details

Get detailed board information including its lists and cards.

get_card

Get comprehensive card details including members, labels and checklists.

create_card

Create new cards in any list with descriptions, due dates and assignments.

update_card

Update card properties such as name, description, due date and status.

move_card

Move cards between lists to update workflow status.

trello_add_comment

Add comments to cards for team communication.

trello_get_list_cards

Get all cards in a specific list.

trello_create_list

Create new lists on boards.

trello_get_board_cards

Get all cards from a board with filtering.

trello_get_card_actions

Get card activity history.

trello_get_card_attachments

Get card attachments and linked files.

trello_get_card_checklists

Get card checklists and checklist items.

trello_get_board_members

Get board members.

trello_get_board_labels

Get board labels for categorization.

trello_get_member

Get member details.

list_boards

Legacy tool: list the user's boards (backward compatibility).

get_lists

Legacy tool: get lists in a board (backward compatibility).

What this server can do

Trello MCP provides tools for these capabilities — tap one to see every MCP server that does the same:

When to use it

  • Show all your Trello boards and drill into board details from your AI assistant
  • Create cards (e.g. 'Update documentation') in a specific list using natural language
  • Move cards between lists to update workflow status (e.g. In Progress to Done)
  • Add comments to cards to flag work as ready for review
  • Search across all Trello content for cards, boards or members (e.g. all cards with 'bug' in the title)
  • Review card activity history, attachments, checklists, board members and labels

Security notes

Requires a Trello API key and a Trello token (read/write) from https://trello.com/app-key. Credentials are stored locally in the MCP client config and passed via the TRELLO_API_KEY and TRELLO_TOKEN environment variables; they are never transmitted over the network. All Trello API calls use HTTPS. Treat the token like a password — it grants read/write access to your Trello account.

Trello MCP FAQ

Which MCP clients are supported?

Any MCP-compatible client that supports stdio transport, including Claude Desktop, Claude Code (CLI), Gemini CLI, and others. The README provides explicit config blocks for each.

How do I get Trello API credentials?

Visit https://trello.com/app-key, copy your API Key, and generate a Token with read/write access. Set them as TRELLO_API_KEY and TRELLO_TOKEN in your MCP client config.

Are my credentials sent anywhere?

No. Credentials are stored locally in your MCP client's config and are never transmitted over the network. All Trello API calls go directly to Trello over HTTPS.

How many tools does it provide?

19 tools organized into three phases (essential, core operations, advanced features) plus two legacy tools for backward compatibility.

What if I hit a rate limit?

The server includes automatic retry logic and respects Trello's rate limits. If you hit limits, wait a few minutes or reduce request frequency.

Alternatives to Trello MCP

Compare all alternatives →

AI-powered task-management system for AI-driven development that drops into Cursor, Windsurf, Claude Code, and more.

Unverified
stdio (local)
API key
JavaScript
15 tools
Updated 2 months agoRepo

Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus.

Unverified
stdio (local)
No auth
Rust
33 tools
Updated 11 hours agoRepo

Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.

Verified
stdio (local)
API key
Python
11 tools
Updated 2 months agoRepo