Trello MCP Server

Table of Contents

• [Table of Contents](#table-of-contents)

• [Prerequisites](#prerequisites)

• [Pre-installation](#pre-installation)

• [Installation](#installation)

• [Server Modes](#server-modes)

• [Configuration](#configuration)

• [Client Integration](#client-integration)

• [Capabilities](#capabilities)

• [Detailed Capabilities](#detailed-capabilities) - [Board Operations](#board-operations) - [List Operations](#list-operations) - [Card Operations](#card-operations)

• [Usage](#usage)

• [Troubleshooting](#troubleshooting)

• [Contributing](#contributing)

Prerequisites

1. Python 3.12 or higher, can easly managed by `uv`

2. [Claude for Desktop](https://claude.ai/download) installed

3. Trello account and API credentials

4. [uv](https://github.com/astral-sh/uv) package manager installed

Pre-installation

1. Make sure you have installed Claude Desktop App

2. Make sure you have already logged in with your account into Claude.

3. Start Claude

Installation

1. Set up Trello API credentials: - Go to [Trello Apps Administration](https://trello.com/power-ups/admin) - Create a new integration at [New Power-Up or Integration](https://trello.com/power-ups/admin/new) - Fill in your information (you can leave the Iframe connector URL empty) and make sure to select the correct Workspace - Click your app's icon and navigate to "API key" from left sidebar. - Copy your "API key" and on the right side: "you can manually generate a Token." click the word token to get your Trello Token.

2. Rename the `.env.example` file in the project root with `.env` and set vairables you just got:

1. Install uv if you haven't already:

1. Clone this repository:

1. Install dependencies and set server for Claude using uv::

1. Restart Claude Desktop app

Server Modes

Claude App Mode

1. Set `USE_CLAUDE_APP=true` in your `.env` file (this is the default)

2. Run the server with:

1. Restart the Claude Desktop application

SSE Server Mode

1. Set `USE_CLAUDE_APP=false` in your `.env` file

2. Run the server with:

1. The server will be available at `http://localhost:8000` by default (or your configured port)

Docker Mode

1. Make sure you have Docker and Docker Compose installed

2. Create your `.env` file with your configuration

3. Build and start the container:

1. The server will run in SSE mode by default

2. To view logs:

1. To stop the server:

Configuration

Client Integration

Using with Claude Desktop

1. Run the server in Claude app mode (`USE_CLAUDE_APP=true`)

2. Start or restart Claude Desktop

3. Claude will automatically detect and connect to your MCP server

Using with Cursor

1. Run the server in SSE mode (`USE_CLAUDE_APP=false`)

2. In Cursor, go to Settings (gear icon) > AI > Model Context Protocol

3. Add a new server with URL `http://localhost:8000` (or your configured host/port)

4. Select the server when using Cursor's AI features

Using with Other MCP Clients

Minimal Client Example

Capabilities

Detailed Capabilities

Board Operations

• Read all boards

• Read specific board details

List Operations

• Read all lists in a board

• Read specific list details

• Create new lists

• Update list name

• Archive (delete) lists

Card Operations

• Read all cards in a list

• Read specific card details

• Create new cards

• Update card attributes

• Delete cards

Usage

• "Show me all my boards"

• "What lists are in board [board_name]?"

• "Create a new card in list [list_name] with title [title]"

• "Update the description of card [card_name]"

• "Archive the list [list_name]"

Troubleshooting

1. Verify your Trello API credentials in the `.env` file

2. Check that you have proper permissions in your Trello workspace

3. Ensure Claude for Desktop is running the latest version

4. Check the logs for any error messages with `uv run mcp dev main.py` command.

5. Make sure uv is properly installed and in your PATH

Contributing