Labsco
m0xai logo

Trello

★ 55

from m0xai

Trello integration for working with boards, lists in boards and cards in lists.

🔥🔥🔥✓ VerifiedFreeAdvanced setup
#automation#devops#git#project-mgmt

Trello MCP Server

A powerful MCP server for interacting with Trello boards, lists, and cards via AI Hosts.

Table of Contents

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:
uv run mcp install main.py
  1. 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:
python main.py
  1. 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:
docker-compose up -d
  1. The server will run in SSE mode by default
  2. To view logs:
docker-compose logs -f
  1. To stop the server:
docker-compose down

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)
  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

You can also add this configuration to your Cursor settings JSON file (typically at ~/.cursor/mcp.json):

{
  "mcpServers": {
    "trello": {
      "url": "http://localhost:8000/sse"
    }
  }
}

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:

import asyncio
import httpx

async def connect_to_mcp_server():
    url = "http://localhost:8000/sse"
    headers = {"Accept": "text/event-stream"}
    
    async with httpx.AsyncClient() as client:
        async with client.stream("GET", url, headers=headers) as response:
            # Get the session ID from the first SSE message
            session_id = None
            async for line in response.aiter_lines():
                if line.startswith("data:"):
                    data = line[5:].strip()
                    if "session_id=" in data and not session_id:
                        session_id = data.split("session_id=")[1]
                        
                        # Send a message using the session ID
                        message_url = f"http://localhost:8000/messages/?session_id={session_id}"
                        message = {
                            "role": "user",
                            "content": {
                                "type": "text",
                                "text": "Show me my Trello boards"
                            }
                        }
                        await client.post(message_url, json=message)

if __name__ == "__main__":
    asyncio.run(connect_to_mcp_server())

Capabilities

OperationBoardListCardChecklistChecklist 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