Trello

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.

- 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

npm install @modelcontextprotocol/mcp-server-trello

Add the server to your MCP settings file with the following configuration:

{ "mcpServers": { "trello": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-trello"], "env": { "TRELLO_API_KEY": "your-api-key", "TRELLO_TOKEN": "your-token", "TRELLO_BOARD_ID": "your-board-id" } } } }

- TRELLO_API_KEY: Your Trello API key (get fromhttps://trello.com/app-key)
- TRELLO_TOKEN: Your Trello token (generate using your API key)
- TRELLO_BOARD_ID: ID of the Trello board to interact with (found in board URL)

{ name: 'get_cards_by_list_id', arguments: { listId: string // ID of the Trello list } }

{ name: 'get_lists', arguments: {} }

{ name: 'get_recent_activity', arguments: { limit?: number // Optional: Number of activities to fetch (default: 10) } }

{ name: 'add_card_to_list', arguments: { listId: string, // ID of the list to add the card to name: string, // Name of the card description?: string, // Optional: Description of the card dueDate?: string, // Optional: Due date (ISO 8601 format) labels?: string[] // Optional: Array of label IDs } }

{ name: 'update_card_details', arguments: { cardId: string, // ID of the card to update name?: string, // Optional: New name for the card description?: string, // Optional: New description dueDate?: string, // Optional: New due date (ISO 8601 format) labels?: string[] // Optional: New array of label IDs } }

{ name: 'archive_card', arguments: { cardId: string // ID of the card to archive } }

{ name: 'add_list_to_board', arguments: { name: string // Name of the new list } }

{ name: 'archive_list', arguments: { listId: string // ID of the list to archive } }

Fetch all cards assigned to the current user.

{ name: 'get_my_cards', arguments: {} }

The server implements a token bucket algorithm for rate limiting to comply with Trello's API limits:

- 300 requests per 10 seconds per API key
- 100 requests per 10 seconds per token

Rate limiting is handled automatically, and requests will be queued if limits are reached.

The server provides detailed error messages for various scenarios:

- Invalid input parameters
- Rate limit exceeded
- API authentication errors
- Network issues
- Invalid board/list/card IDs

git clone https://github.com/modelcontextprotocol/server-trello.git cd server-trello

Contributions are welcome! Please read ourContributing Guidefor details on our code of conduct and the process for submitting pull requests.

This project is licensed under the MIT License - see theLICENSEfile for details.

- Built with theModel Context Protocol SDK
- Uses theTrello REST API

From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.