home / mcp / trello mcp server

Trello MCP Server

Exposes Trello board/list/card management via MCP for Claude with secure API access.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aepod-trello-mcp": {
      "command": "node",
      "args": [
        "/path/to/trello-mcp/dist/index.js"
      ],
      "env": {
        "TRELLO_TOKEN": "your_token_here",
        "TRELLO_API_KEY": "your_api_key_here"
      }
    }
  }
}

This MCP server lets Claude interact with Trello by exposing board, list, card, and checklist operations through the Trello REST API. It handles authentication, error handling, and rate limiting, so you can manage Trello data from natural language commands in your MCP-enabled client.

How to use

You connect to the Trello MCP Server from your MCP client (for example Claude Desktop) and talk to it using natural language. You can list boards, view board details, create lists, create and manage cards, assign members, apply labels, and work with checklists. The server translates your requests into Trello API actions and returns structured results or confirmations.

How to install

Prerequisites you need before installation include Node.js 18 or newer, npm, a Trello account with API access, and Claude Desktop.

Step 1: Clone the project and move into the directory.

git clone <repository-url>
cd trello-mcp

Step 2: Install dependencies.

npm install

Step 3: Build the project.

npm run build

Step 4: Prepare Trello API credentials. You will need an API key and a token created for your server access.

Step 5: Create an environment file in the project root to store credentials.

TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here

Configuration and runtime setup

The Trello MCP Server runs as a local process. You can start it using a standard Node command and supply credentials via environment variables.

node /path/to/trello-mcp/dist/index.js

Available tools

list_boards

List all boards accessible to your Trello account and return their basic metadata.

get_board

Fetch detailed information about a specific board, including metadata and settings.

get_board_members

Retrieve the members assigned to a board.

get_lists

Get all lists within a board to understand structure and placement of cards.

create_list

Create a new list within a specified board.

update_list

Update properties of a list, such as its name or position.

get_cards

Retrieve cards from a board or a specific list, with optional filtering.

create_card

Create a new card in a chosen list with name, description, and optional due date.

update_card

Update card properties including name, description, and due date.

move_card

Move a card to a different list within the same board.

delete_card

Remove a card from a board.

add_card_member

Associate a member with a card.

remove_card_member

Remove a member from a card.

get_labels

List labels available on a board.

add_card_label

Attach a label to a card.

remove_card_label

Detach a label from a card.

get_card_checklists

Get checklists on a card.

create_checklist

Create a new checklist on a card.

add_checklist_item

Add an item to a checklist.

update_checklist_item

Update a checklist item to mark it complete or incomplete.