Overview
What is MCP Server Trello?
MCP Server Trello is a Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. It integrates with the Trello API while automatically handling rate limiting, type safety, and error handling. This server is for developers and AI agents who need to manage Trello boards programmatically through an MCP-enabled client.
How to use MCP Server Trello?
Install the package via npm (npm install @modelcontextprotocol/mcp-server-trello), then add it to your MCP settings file with the required environment variables: TRELLO_API_KEY, TRELLO_TOKEN, and TRELLO_BOARD_ID. The server exposes tools such as get_cards_by_list_id, get_lists, add_card_to_list, update_card_details, archive_card, archive_list, and get_my_cards.
Key features of MCP Server Trello
- Full Trello board integration: cards, lists, and board activities
- Built-in rate limiting complying with Trello's API limits
- Type-safe implementation in TypeScript with comprehensive definitions
- Robust input validation for all API inputs
- Graceful error handling with informative messages
Use cases of MCP Server Trello
- Automate adding cards to specific Trello lists from a chatbot
- Fetch and display recent board activity for a monitoring dashboard
- Archive outdated cards or lists in bulk
- Update card details (name, description, due date, labels) via AI agent
- Retrieve all cards assigned to the current user for personal task lists
FAQ from MCP Server Trello
What does this server do that the Trello API alone doesn't?
It wraps the Trello REST API within the Model Context Protocol, providing type‑safe tools, automatic rate limiting (token bucket algorithm), input validation, and structured error handling—all without requiring manual API management.
What dependencies or runtime are required?
Node.js version 16 or higher and npm or yarn. The package is installed via npm (@modelcontextprotocol/mcp-server-trello) and run with npx -y as shown in the configuration example.
How do I get my Trello API key, token, and board ID?
Obtain your API key from https://trello.com/app-key. Generate a token using that key. The board ID is found in the board’s URL (the alphanumeric string after /b/).
What are the rate limits?
Trello allows 300 requests per 10 seconds per API key and 100 requests per 10 seconds per token. The server handles queuing automatically when limits are reached.
What tools are available?
The server provides 8 tools: get_cards_by_list_id, get_lists, get_recent_activity, add_card_to_list, update_card_details, archive_card, add_list_to_board, archive_list, and get_my_cards. Each accepts typed arguments and returns structured data.
