Uses environment variables to securely store and access Trello API credentials required for authentication.
Provides comprehensive Trello board management capabilities including reading boards, manipulating lists (create, read, update, delete), and managing cards (create, read, update, delete) across Trello workspaces.
Trello MCP Server
A powerful MCP server for interacting with Trello boards, lists, and cards via AI Hosts.
Table of Contents
- Table of Contents
- Prerequisites
- Pre-installation
- Installation
- Server Modes
- Configuration
- Client Integration
- Capabilities
- Detailed Capabilities
- Usage
- Troubleshooting
- Contributing
Prerequisites
- Python 3.12 or higher, can easly managed by
uv
- Claude for Desktop installed
- Trello account and API credentials
- uv package manager installed
Pre-installation
- Make sure you have installed Claude Desktop App
- Make sure you have already logged in with your account into Claude.
- Start Claude
Installation
- Set up Trello API credentials:
- Go to Trello Apps Administration
- Create a new integration at New Power-Up or Integration
- 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.
- Rename the
.env.example
file in the project root with.env
and set vairables you just got:
- Install uv if you haven't already:
- Clone this repository:
- Install dependencies and set server for Claude using uv::
- Restart Claude Desktop app
Server Modes
This MCP server can run in two different modes:
Claude App Mode
This mode integrates directly with the Claude Desktop application:
- Set
USE_CLAUDE_APP=true
in your.env
file (this is the default) - Run the server with:
- Restart the Claude Desktop application
SSE Server Mode
This mode runs as a standalone SSE server that can be used with any MCP-compatible client, including Cursor:
- Set
USE_CLAUDE_APP=false
in your.env
file - Run the server with:
- The server will be available at
http://localhost:8000
by default (or your configured port)
Docker Mode
You can also run the server using Docker Compose:
- Make sure you have Docker and Docker Compose installed
- Create your
.env
file with your configuration - Build and start the container:
- The server will run in SSE mode by default
- To view logs:
- To stop the server:
Configuration
The server can be configured using environment variables in the .env
file:
Variable | Description | Default |
---|---|---|
TRELLO_API_KEY | Your Trello API key | Required |
TRELLO_TOKEN | Your Trello API token | Required |
MCP_SERVER_NAME | The name of the MCP server | Trello MCP Server |
MCP_SERVER_HOST | Host address for SSE mode | 0.0.0.0 |
MCP_SERVER_PORT | Port for SSE mode | 8000 |
USE_CLAUDE_APP | Whether to use Claude app mode | true |
You can customize the server by editing these values in your .env
file.
Client Integration
Using with Claude Desktop
- Run the server in Claude app mode (
USE_CLAUDE_APP=true
) - Start or restart Claude Desktop
- Claude will automatically detect and connect to your MCP server
Using with Cursor
To connect your MCP server to Cursor:
- Run the server in SSE mode (
USE_CLAUDE_APP=false
) - In Cursor, go to Settings (gear icon) > AI > Model Context Protocol
- Add a new server with URL
http://localhost:8000
(or your configured host/port) - Select the server when using Cursor's AI features
You can also add this configuration to your Cursor settings JSON file (typically at ~/.cursor/mcp.json
):
Using with Other MCP Clients
For other MCP-compatible clients, point them to the SSE endpoint at http://localhost:8000
.
Minimal Client Example
Here's a minimal Python example to connect to the SSE endpoint:
Capabilities
Operation | Board | List | Card | Checklist | Checklist Item |
---|---|---|---|---|---|
Read | ✅ | ✅ | ✅ | ✅ | ✅ |
Write | ❌ | ✅ | ✅ | ✅ | ✅ |
Update | ❌ | ✅ | ✅ | ✅ | ✅ |
Delete | ❌ | ✅ | ✅ | ✅ | ✅ |
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
Checklist Operations
- ✅ Get a specific checklist
- ✅ List all checklists in a card
- ✅ Create a new checklist
- ✅ Update a checklist
- ✅ Delete a checklist
- ✅ Add checkitem to checklist
- ✅ Update checkitem
- ✅ Delete checkitem
Usage
Once installed, you can interact with your Trello boards through Claude. Here are some example queries:
- "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]"
Here are my example usages:
Troubleshooting
If you encounter issues:
- Verify your Trello API credentials in the
.env
file - Check that you have proper permissions in your Trello workspace
- Ensure Claude for Desktop is running the latest version
- Check the logs for any error messages with
uv run mcp dev main.py
command. - Make sure uv is properly installed and in your PATH
Contributing
Feel free to submit issues and enhancement requests!
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A powerful MCP server for interacting with Trello boards, lists, and cards via AI Hosts.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that enables AI assistants like Claude to interact with Anki flashcard decks, allowing users to create, manage, and update flashcards through natural language conversations.Last updated -1TypeScript
- -securityFlicense-qualityA specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.Last updated -715TypeScript
- -securityFlicense-qualityA MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.Last updated -5TypeScript
- AsecurityAlicenseAqualityAn MCP server implementation that allows AI assistants to access, search, and interact with Dev.to content, including fetching articles, retrieving user information, and publishing new content.Last updated -1053PythonMIT License