MCP Server 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.
<a href="https://glama.ai/mcp/servers/klqkamy7wt"><img width="380" height="200" src="https://glama.ai/mcp/servers/klqkamy7wt/badge" alt="Server Trello MCP server" /></a>
Changelog
0.1.2
- Added Docker support with multi-stage build
- Improved security by moving environment variables to
.env
- Added Docker Compose configuration
- Added
.env.templatefor easier setup
0.1.1
- Added
move_cardtool to move cards between lists
- Improved documentation
0.1.0
- Initial release with basic Trello board management features
Features
- 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
Installation
Docker Installation (Recommended)
The easiest way to run the server is using Docker:
- Clone the repository:
- Copy the environment template and fill in your Trello credentials:
- Build and run with Docker Compose:
Installing via Smithery
To install Trello Server for Claude Desktop automatically via Smithery:
Manual Installation
Configuration
The server can be configured using environment variables. Create a
.env file in the root directory with the following variables:You can get these values from:
- API Key: https://trello.com/app-key
- Token: Generate using your API key
- Board ID: Found in the board URL
Available Tools
get_cards_by_list_id
Fetch all cards from a specific list.
get_lists
Retrieve all lists from the configured board.
get_recent_activity
Fetch recent activity on the board.
add_card_to_list
Add a new card to a specified list.
update_card_details
Update an existing card's details.
archive_card
Send a card to the archive.
add_list_to_board
Add a new list to the board.
archive_list
Send a list to the archive.
get_my_cards
Fetch all cards assigned to the current user.
move_card
Move a card to a different list.
Rate Limiting
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.
Error Handling
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
Development
Prerequisites
- Node.js 16 or higher
- npm or yarn
Setup
- Clone the repository
- Install dependencies
- Build the project
Contributing
Contributions are welcome!
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Built with the Model Context Protocol SDK
- Uses the Trello REST API
MCP Server 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.
<a href="https://glama.ai/mcp/servers/klqkamy7wt"><img width="380" height="200" src="https://glama.ai/mcp/servers/klqkamy7wt/badge" alt="Server Trello MCP server" /></a>
Changelog
0.1.2
- Added Docker support with multi-stage build
- Improved security by moving environment variables to
.env
- Added Docker Compose configuration
- Added
.env.templatefor easier setup
0.1.1
- Added
move_cardtool to move cards between lists
- Improved documentation
0.1.0
- Initial release with basic Trello board management features
Features
- 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
Installation
Docker Installation (Recommended)
The easiest way to run the server is using Docker:
- Clone the repository:
- Copy the environment template and fill in your Trello credentials:
- Build and run with Docker Compose:
Installing via Smithery
To install Trello Server for Claude Desktop automatically via Smithery:
Manual Installation
Configuration
The server can be configured using environment variables. Create a
.env file in the root directory with the following variables:You can get these values from:
- API Key: https://trello.com/app-key
- Token: Generate using your API key
- Board ID: Found in the board URL
Available Tools
get_cards_by_list_id
Fetch all cards from a specific list.
get_lists
Retrieve all lists from the configured board.
get_recent_activity
Fetch recent activity on the board.
add_card_to_list
Add a new card to a specified list.
update_card_details
Update an existing card's details.
archive_card
Send a card to the archive.
add_list_to_board
Add a new list to the board.
archive_list
Send a list to the archive.
get_my_cards
Fetch all cards assigned to the current user.
move_card
Move a card to a different list.
Rate Limiting
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.
Error Handling
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
Development
Prerequisites
- Node.js 16 or higher
- npm or yarn
Setup
- Clone the repository
- Install dependencies
- Build the project
Contributing
Contributions are welcome!
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Built with the Model Context Protocol SDK
- Uses the Trello REST API