The MCP Server Trello provides tools for interacting with Trello boards through the Model Context Protocol. It handles Trello API integration with automatic rate limiting, type safety, and error handling, allowing you to manage cards, lists, and board activities seamlessly.
git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello
cp .env.template .env
docker compose up --build
For automatic installation with Claude Desktop:
npx -y @smithery/cli install @modelcontextprotocol/mcp-server-trello --client claude
npm install @delorenj/mcp-server-trello
Create a .env file in the root directory with your Trello credentials:
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
TRELLO_BOARD_ID=your-board-id
You can obtain these values from:
Retrieve all lists from the configured board:
{
name: 'get_lists',
arguments: {}
}
Add a list to the board:
{
name: 'add_list_to_board',
arguments: {
name: string // Name of the new list
}
}
Send a list to the archive:
{
name: 'archive_list',
arguments: {
listId: string // ID of the list to archive
}
}
Fetch all cards from a specific list:
{
name: 'get_cards_by_list_id',
arguments: {
listId: string // ID of the Trello list
}
}
Fetch all cards assigned to the current user:
{
name: 'get_my_cards',
arguments: {}
}
Add a card to a specified list:
{
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
}
}
Update an existing card's details:
{
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
}
}
Move a card to a different list:
{
name: 'move_card',
arguments: {
cardId: string, // ID of the card to move
listId: string // ID of the target list
}
}
Send a card to the archive:
{
name: 'archive_card',
arguments: {
cardId: string // ID of the card to archive
}
}
Fetch recent activity on the board:
{
name: 'get_recent_activity',
arguments: {
limit?: number // Optional: Number of activities to fetch (default: 10)
}
}
The server automatically handles Trello's API rate limits:
Requests will be queued if limits are reached, and the server provides detailed error messages for various scenarios including invalid parameters, authentication errors, and network issues.
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.
To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".
When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:
{
"mcpServers": {
"cursor-rules-mcp": {
"command": "npx",
"args": [
"-y",
"cursor-rules-mcp"
]
}
}
}
To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.