m0xai/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
- Board Operations
- List Operations
- Card Operations
- Usage
- Troubleshooting
- Contributing
Prerequisites
1. Python 3.12 or higher, can easly managed by uv
2. Claude for Desktop installed
3. Trello account and API credentials
4. 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
- 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.
2. Rename the .env.example file in the project root with .env and set vairables you just got:
3. Install uv if you haven't already:
4. Clone this repository:
5. Install dependencies and set server for Claude using uv::
6. 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:
1. Set USE_CLAUDE_APP=true in your .env file (this is the default)
2. Run the server with:
3. 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:
1. Set USE_CLAUDE_APP=false in your .env file
2. Run the server with:
3. 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:
1. Make sure you have Docker and Docker Compose installed
2. Create your .env file with your configuration
3. Build and start the container:
4. The server will run in SSE mode by default
5. To view logs:
6. 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
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
To connect your MCP server to Cursor:
1. Run the server in SSE mode (USE_CLAUDE_APP=false)