Trello MCP server for AI agents

This MCP server provides a bridge between Model Context Protocol and the Trello API, allowing you to interact with Trello boards, lists, cards, and other resources through a structured interface. It offers comprehensive coverage of Trello functionality with proper TypeScript typing.

Prerequisites

Node.js 18 or higher
npm or yarn
Trello API key and token

Installation

Clone and Setup

Clone the repository:

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

Install dependencies:
```
npm install
```
Create a .env file based on the example:
```
cp .env.example .env
```
Edit the .env file with your Trello credentials:
```
TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token
```
You can obtain these from the Trello Developer Portal.

Building and Running

Build the project:

npm run build

Start the server:

npm start

Available Tools

The server provides a comprehensive set of tools for interacting with Trello resources.

Board Tools

get_boards - Retrieve all boards for the authenticated user
get_board - Get a specific board by ID
create_board - Create a new board
update_board - Update an existing board
delete_board - Delete a board
get_board_lists - Get all lists on a board
get_board_members - Get all members of a board
get_board_labels - Get all labels on a board
close_board - Close (archive) a board
reopen_board - Reopen a closed board

List Tools

get_list - Get a specific list by ID
create_list - Create a new list on a board
update_list - Update an existing list
archive_list - Archive a list
unarchive_list - Unarchive a list
move_list_to_board - Move a list to a different board
get_cards_in_list - Get all cards in a list
archive_all_cards - Archive all cards in a list
move_all_cards - Move all cards in a list to another list
update_list_position - Update the position of a list on a board
update_list_name - Update the name of a list
subscribe_to_list - Subscribe to a list

Card Tools

get_card - Get a specific card by ID
create_card - Create a new card
update_card - Update an existing card
delete_card - Delete a card
archive_card - Archive a card
unarchive_card - Unarchive a card
move_card_to_list - Move a card to a different list
add_comment - Add a comment to a card
get_comments - Get comments on a card
add_attachment - Add an attachment to a card
get_attachments - Get attachments on a card
delete_attachment - Delete an attachment from a card
add_member - Add a member to a card
remove_member - Remove a member from a card
add_label - Add a label to a card
remove_label - Remove a label from a card
set_due_date - Set the due date for a card
set_due_complete - Mark a card's due date as complete or incomplete

Member Tools

get_me - Get the authenticated member (current user)
get_member - Get a specific member by ID or username
get_member_boards - Get boards that a member belongs to
get_member_cards - Get cards assigned to a member
get_boards_invited - Get boards that a member has been invited to
get_member_organizations - Get organizations that a member belongs to
get_notifications - Get notifications for the authenticated member
update_me - Update the authenticated member's information
get_avatar - Get the authenticated member's avatar
search_members - Search for members by name

Label Tools

get_label - Get a specific label by ID
create_label - Create a new label on a board
update_label - Update an existing label
delete_label - Delete a label
get_board_labels - Get all labels on a board
update_label_name - Update the name of a label
update_label_color - Update the color of a label
create_label_on_card - Create a new label directly on a card
get_card_labels - Get all labels on a card
add_label_to_card - Add a label to a card
remove_label_from_card - Remove a label from a card

Checklist Tools

get_checklist - Get a specific checklist by ID
create_checklist - Create a new checklist on a card
update_checklist - Update an existing checklist
delete_checklist - Delete a checklist
get_checkitems - Get all checkitems on a checklist
create_checkitem - Create a new checkitem on a checklist
get_checkitem - Get a specific checkitem on a checklist
update_checkitem - Update a checkitem on a checklist
delete_checkitem - Delete a checkitem from a checklist
update_checklist_name - Update the name of a checklist
update_checklist_position - Update the position of a checklist on a card

Configuration

The server can be configured through:

Environment variables
Command line arguments (with --env KEY=VALUE)
Default values in the code

Required environment variables:

TRELLO_API_KEY - Your Trello API key
TRELLO_TOKEN - Your Trello API token

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "trello" '{"command":"npx","args":["-y","trello-mcp-server"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

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.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "trello": {
            "command": "npx",
            "args": [
                "-y",
                "trello-mcp-server"
            ]
        }
    }
}

Adding an MCP server to a project

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.

How to use the MCP server

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 explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "trello": {
            "command": "npx",
            "args": [
                "-y",
                "trello-mcp-server"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect