
Trello MCP
Comprehensive Trello integration for Claude Desktop, Claude Code, Gemini CLI and other MCP clients — 19 tools for boards, cards and lists.
Add to your client
Copy the config for your MCP client and paste it into its config file.
git clone https://github.com/kocakli/trello-desktop-mcp.git && cd trello-desktop-mcp && npm install && npm run buildPaste 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_searchUniversal search across all Trello content (boards, cards, members, organizations).
trello_get_user_boardsGet all boards accessible to the current user.
get_board_detailsGet detailed board information including its lists and cards.
get_cardGet comprehensive card details including members, labels and checklists.
create_cardCreate new cards in any list with descriptions, due dates and assignments.
update_cardUpdate card properties such as name, description, due date and status.
move_cardMove cards between lists to update workflow status.
trello_add_commentAdd comments to cards for team communication.
trello_get_list_cardsGet all cards in a specific list.
trello_create_listCreate new lists on boards.
trello_get_board_cardsGet all cards from a board with filtering.
trello_get_card_actionsGet card activity history.
trello_get_card_attachmentsGet card attachments and linked files.
trello_get_card_checklistsGet card checklists and checklist items.
trello_get_board_membersGet board members.
trello_get_board_labelsGet board labels for categorization.
trello_get_memberGet member details.
list_boardsLegacy tool: list the user's boards (backward compatibility).
get_listsLegacy 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.
Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus.
Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.
Compare Trello MCP with: