Claude MCP Trello

What is Claude MCP Trello?

An MCP server that provides tools for interacting with Trello boards, integrating with Trello’s API while handling rate limiting, type safety, and error handling automatically. It enables seamless board, list, card, and activity management through a set of predefined tools.

How to use Claude MCP Trello?

Install dependencies with npm install, build with npm run build, then add a configuration entry to Claude Desktop’s claude_desktop_config.json specifying the Node.js path, the built script path, and your TRELLO_API_KEY and TRELLO_TOKEN environment variables. Once configured, Claude can invoke any of the 11 tools to interact with your Trello data.

Key features of Claude MCP Trello

• Full Trello board integration: cards, lists, and activities.
• Built-in rate limiting that respects Trello’s API limits.
• Type‑safe implementation with comprehensive TypeScript definitions.
• Input validation and graceful error handling.
• 11 tools for CRUD operations, search, and attachment management.

Use cases of Claude MCP Trello

• Automatically add cards to lists based on natural language prompts.
• Retrieve recent board activity for status updates or monitoring.
• Search across all boards in a workspace for cards or conversations.
• List and download attachments from Trello cards for further processing.
• Archive or update cards and lists without manual UI navigation.

FAQ from Claude MCP Trello

What are the prerequisites to run Claude MCP Trello?

You need Node.js 16 or higher, npm or yarn, a Trello API key, and a Trello token. The server uses these credentials via the TRELLO_API_KEY and TRELLO_TOKEN environment variables.

How do I integrate this MCP server with Claude Desktop?

Add a configuration entry to ~/Library/Application Support/Claude/claude_desktop_config.json with the command pointing to your Node.js binary, the args pointing to the built index.js file, and the env object containing your Trello API key and token.

How does rate limiting work?

The server implements a token bucket algorithm to stay within Trello’s limits: 300 requests per 10 seconds per API key and 100 requests per 10 seconds per token. Requests are automatically queued when a limit is reached.

What tools are included?

The server offers 11 tools: trello_get_cards_by_list, trello_get_lists, trello_get_recent_activity, trello_add_card, trello_update_card, trello_archive_card, trello_add_list, trello_archive_list, trello_get_my_cards, trello_search_all_boards, trello_get_card_attachments, and trello_download_attachment.

What kind of error messages can I expect?

The server returns detailed error messages for invalid input parameters, rate limit exceeded, API authentication errors, network issues, and invalid board/list/card IDs.