The MCP Server Trello provides comprehensive tools for interacting with Trello boards, lists, and cards with seamless API integration.
Board and Workspace Management:
- List and set active boards and workspaces dynamically
- List boards in specific workspaces
- Get active board information
- Persistent configuration between restarts
Card Operations:
- Fetch, add, update, and archive cards
- Move cards between lists
- Attach images from URLs
- Get cards assigned to current user
List Operations:
- Retrieve all lists from active board
- Add and archive lists
- Get cards by list ID
Additional Features:
- Activity tracking with customizable limits
- Automatic rate limit handling
- Robust error handling with detailed messages
- TypeScript implementation with input validation
Provides tools for interacting with Trello boards, including fetching cards and lists, adding new cards and lists, updating card details, archiving cards and lists, and fetching recent activity.
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.
Changelog
0.3.0
- Added board and workspace management capabilities:
list_boards
- List all boards the user has access toset_active_board
- Set the active board for future operationslist_workspaces
- List all workspaces the user has access toset_active_workspace
- Set the active workspace for future operationslist_boards_in_workspace
- List all boards in a specific workspaceget_active_board_info
- Get information about the currently active board
- Added persistent configuration storage to remember active board/workspace
- Improved error handling for all new operations
0.2.1
- Added detailed JSDoc comments to rate limiter functions
- Improved error handling for image attachment functionality
- Updated documentation for attach_image_to_card tool
0.2.0
- Added
attach_image_to_card
tool to attach images to cards from URLs - Added Docker support with multi-stage build
- Improved security by moving environment variables to
.env
- Added Docker Compose configuration
- Added
.env.template
for easier setup
0.1.1
- Added
move_card
tool 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
- Dynamic Board Selection: Switch between boards and workspaces without restarting
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
Environment Variables
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 (e.g., https://trello.com/b/BOARD_ID/board-name)
- Workspace ID: Found in workspace settings or using
list_workspaces
tool
Board and Workspace Management
Starting with version 0.3.0, the MCP server supports dynamic board and workspace selection:
- The
TRELLO_BOARD_ID
in your.env
file is used as the initial board ID when the server starts - You can change the active board at any time using the
set_active_board
tool - The selected board persists between server restarts (stored in
~/.trello-mcp/config.json
) - Similarly, you can set and persist an active workspace using
set_active_workspace
This allows you to work with multiple boards and workspaces without restarting the server or changing environment variables.
Example Workflow
- Start by listing available boards:
- Set your active board:
- List workspaces if needed:
- Set active workspace if needed:
- Check current active board info:
Available Tools
get_cards_by_list_id
Fetch all cards from a specific list.
get_lists
Retrieve all lists from the currently active board.
get_recent_activity
Fetch recent activity on the currently active 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 currently active 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.
attach_image_to_card
Attach an image to a card directly from a URL.
list_boards
List all boards the user has access to.
set_active_board
Set the active board for future operations.
list_workspaces
List all workspaces the user has access to.
set_active_workspace
Set the active workspace for future operations.
list_boards_in_workspace
List all boards in a specific workspace.
get_active_board_info
Get information about the currently active board.
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
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Facilitates interaction with Trello boards via the Trello API, offering features like rate limiting, type safety, input validation, and error handling for seamless management of cards, lists, and board activities.
- Changelog
- Features
- Installation
- Configuration
- Available Tools
- Rate Limiting
- Error Handling
- Development
- Contributing
- License
- Acknowledgments
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityEnables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.Last updated -5JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.Last updated -103JavaScriptMIT License
- -securityAlicense-qualityConnects to Trello with all the tools available that I was able to find in API referenceLast updated -31TypeScriptMIT License
- AsecurityAlicenseAqualityEnables seamless integration with Trello boards, allowing users to manage cards, lists, and activities while automatically handling rate limiting and providing type safety.Last updated -9TypeScriptMIT License