Trello MCP Server

Trello MCP Server is a powerful service that interacts with Trello boards, lists, and cards through an AI host, supporting read, create, update, and delete operations.

Schedule management Developer tools #Trello integration #AI assistant #Project management .Python

rating : 2.5 points

downloads : 23

update time : 2025-04-28

What is Trello MCP Server?

Trello MCP Server is a middleware service that allows you to directly manage and operate your Trello boards through an AI assistant (such as Claude or Cursor). It converts natural language instructions into Trello API calls to provide a seamless task management experience.

How to use Trello MCP Server?

You can use it in three ways: 1) Integrate it into the Claude desktop application. 2) Run it as an independent SSE server. 3) Deploy it using a Docker container. After installation, simply describe your requirements in natural language, and the AI will help you complete Trello operations.

Use cases

It is especially suitable for users who need to frequently manage Trello tasks, such as project managers, development teams, or individuals for personal task management. You can complete operations such as card creation and list management through the voice or chat interface without manually operating the Trello interface.

Main features

Board operationsView all boards and their detailed information

List operationsView, create, update, and archive lists

Card operationsComprehensive card management: create, view, update, and delete

Multi - mode operationSupports three operation modes: Claude application integration, SSE server, and Docker

Advantages and limitations

Advantages

Natural language interaction without the need to learn complex APIs

Seamless integration with commonly used AI tools (Claude/Cursor)

Supports multiple deployment methods to flexibly adapt to different environments

Complete coverage of Trello functions to meet basic management needs

Limitations

Currently does not support write operations at the board level (create/modify/delete boards)

Requires pre - configuration of Trello API credentials

Depends on the availability of third - party AI services

How to use

Get Trello API credentials

Create an application in the Trello developer portal and obtain the API Key and Token

Configure the environment

Copy.env.example to.env and fill in your credentials

Select the operation mode

Decide whether to use the Claude integration mode, SSE server mode, or Docker mode

Start the service

Run the corresponding command to start the server according to the selected mode

Connect the client

Configure the connection in Claude or Cursor, or use other MCP - compatible clients

Usage examples

Project managementQuickly view the status of the project board and add new tasks

Personal task managementManage personal to - do items through voice instructions

Team collaborationQuickly assign tasks to team members

Frequently Asked Questions

Why can't I create or modify boards?

How to check if the service is running normally?

Which client applications are supported?

Is my Trello data secure?

Related resources

Trello API documentation

Official Trello API reference documentation

MCP protocol specification

Model Context Protocol technical specification

GitHub repository

Project source code and latest version

uv package manager

Recommended Python package management tool

🚀 Trello MCP Server

The Trello MCP Server is a powerful tool that allows users to interact with the Trello API. It provides a range of operations for Boards, Lists, and Cards, enabling efficient management of Trello resources.

🚀 Quick Start

To get started with the Trello MCP Server, follow these steps:

📦 Installation

Clone the repository:

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

Install dependencies:
```
npm install
```
Configure the file:
- Copy config.example.json to config.json.
- Fill in your Trello API key and token.

📚 Documentation

Configuration Guide

Set environment variables:

export TRELLO_API_KEY=your_api_key
export TRELLO_API_TOKEN=your_api_token

Start the service:
```
npm start
```

✨ Features

Function Overview

Operation Type	Board	List	Card
Read	✅	✅	✅
Write	❌	✅	✅
Update	❌	✅	✅
Delete	❌	✅	✅

Detailed Features

Board Operations

✅ Get all Boards.
✅ Get details of a specific Board.

List Operations

✅ Get all Lists in a Board.
✅ Get details of a specific List.
✅ Create a new List.
✅ Update the List name.
✅ Delete a List.

Card Operations

✅ Get all Cards in a List.
✅ Get details of a specific Card.
✅ Create a new Card.
✅ Update Card attributes.
✅ Delete a Card.

💻 Usage Examples

Basic Usage

# Show all Boards
curl http://localhost:3000/boards

# Show Lists under a Board
curl http://localhost:3000/boards/{boardId}/lists

# Create a new List
POST /lists HTTP/1.1
Content-Type: application/json

{
  "name": "New List"
}

# Update the List name
PUT /lists/{listId} HTTP/1.1
Content-Type: application/json

{
  "name": "Updated List Name"
}

Image Examples

Example 1: Query all cards
Example 2: Add a new song card

Troubleshooting

Verify API keys: Ensure that your Trello API key and token are correct.
Check network connection: Confirm that the server can access Trello's API services.
View logs: Check the console output or log files for more error information.