Trello MCP

A Model Context Protocol (MCP) server for querying Trello boards and cards.

Prerequisites

• Node.js installed (v14 or higher)
• Trello API Key and Token

How to Get Trello Credentials

1. Create a Trello Power-Up first at https://trello.com/power-ups/admin
2. Navigate to your Power-Up and select the API Key tab
3. Generate an API Key
4. Create a Token by clicking the "Token" link

Installation & Usage

Option 1: Run directly with npx (recommended)

npx @azareljacobs/trello-mcp

Option 2: Install globally

npm install -g @azareljacobs/trello-mcp
trello-mcp

Option 3: Install as a dependency in your project

npm install @azareljacobs/trello-mcp

Then in your package.json scripts:

"scripts": {
  "trello-mcp": "trello-mcp"
}

Option 4: Clone and run locally

1. Clone the repository
2. Run npm install
3. Run npm start

Setting up Trello API Credentials

You need to provide your Trello API credentials in one of the following ways:

Method 1: Environment Variables

Set the following environment variables:

TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token

Method 2: .env File

Create a .env file in your project directory with:

TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token

Method 3: MCP Configuration

Add the credentials to your MCP configuration file (~/.codeium/windsurf/mcp_config.json) under the "env" section:

{
  "env": {
    "TRELLO_API_KEY": "your_trello_api_key",
    "TRELLO_TOKEN": "your_trello_token"
  }
}

Available MCP Tools

The Trello MCP server provides the following tools:

1. get_boards

Returns all boards for the authenticated user with comprehensive metadata.

• Includes detailed information about members, lists, labels, and cards
• No parameters required
• Note: This can be slow for users with many boards as it makes multiple API calls

2. get_boards_summary

Returns a simplified summary of all boards.

• Includes basic board information and statistics
• No parameters required
• Faster than get_boards while still providing useful metadata

3. get_board_details

Returns detailed information about a specific board.

• Parameters: boardId (required)

{
  "boardId": "your_board_id"
}

4. get_cards

Returns cards from a specific board.

• Parameters:
  • boardId (required)
  • filter (optional, default: "visible")

{
  "boardId": "your_board_id",
  "filter": "visible"
}

5. get_lists

Returns lists from a specific board.

• Parameters: boardId (required)

{
  "boardId": "your_board_id"
}

6. search

Searches across Trello for matching content.

• Parameters: query (required)

{
  "query": "search term"
}

Example Usage with Roo

// Example of using the Trello MCP server with Roo
<use_mcp_tool>
<server_name>trello</server_name>
<tool_name>get_boards_summary</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

// Example of getting cards from a specific board
<use_mcp_tool>
<server_name>trello</server_name>
<tool_name>get_cards</tool_name>
<arguments>
{
  "boardId": "your_board_id"
}
</arguments>
</use_mcp_tool>