Trello MCP

🚀 Trello Matter Handling Process (MCP) Server

An MCP server for handling Trello matters via Claude.

🚀 Quick Start

This server is designed to interact with the Trello API through HTTP requests, enabling seamless handling of Trello matters with the assistance of Claude.

📦 Installation

Using uv Administrator

uv add mcp-server-trello --main main.py --config config.yaml

Manual Run

python3 main.py

✨ Features

Feature Table

Detailed Features

Board Operations

• ✅ Read all Boards
• ✅ Read details of a specific Board

List Operations

• ✅ Read all Lists in a Board
• ✅ Read details of a specific List
• ✅ Create a new List
• ✅ Update a List name
• ✅ Archive (Delete) a List

Card Operations

• ✅ Read all Cards in a List
• ✅ Read details of a specific Card
• ✅ Create a new Card
• ✅ Update Card attributes
• ✅ Delete a Card

Checklist Operations

• ✅ Get a specific Checklist
• ✅ List all Checklists in a Card
• ✅ Create a new Checklist
• ✅ Update a Checklist
• ✅ Delete a Checklist
• ✅ Add a Checklist item
• ✅ Update a Checklist item
• ✅ Delete a Checklist item

💻 Usage Examples

Example Usage Scenarios

Basic Usage

import requests

# Send a request to the SSE endpoint
response = requests.get('http://localhost:8000/stream', stream=True)

# Process the response
for event in response.iter_events():
    if event:
        print(event)

📚 Documentation

Installation and Configuration

During the installation process, it is recommended to read the uv documentation to understand how to manage MCP services.

Function Overview

This server allows interaction with the Trello API through HTTP requests and provides the following features:

• Listen for and handle MCP events
• Support the SSE (Server-Sent Events) protocol
• Provide RESTful API interfaces

Example Request

curl -X POST http://localhost:8000/api/trello/webhook

🔧 Technical Details

Request Handling Process

1. Receive an HTTP request
2. Parse the request data
3. Call the Trello API
4. Process the response and return the result

Code Structure

# main.py
from fastapi import FastAPI

app = FastAPI()

@app.get("/stream")
async def stream_events():
    # Implement SSE logic
    pass

@app.post("/api/trello/webhook")
async def handle_trello_webhook():
    # Handle Trello callback logic
    pass

🚧 Troubleshooting

When encountering issues:

1. Confirm the Trello API credentials in the .env file.
2. Check that your permissions in the Trello workspace are correct.
3. Ensure that the Claude desktop application is running the latest version.
4. Use uv run mcp dev main.py to check the log output.
5. Check the console error messages in the browser.

💡 Usage Tips

Example Code

import requests

# Send a request to the SSE endpoint
response = requests.get('http://localhost:8000/stream', stream=True)

# Process the response
for event in response.iter_events():
    if event:
        print(event)

🤝 Contribution and Support

Submit an Issue

Feel free to submit issues or suggestions on GitHub Issues.

Code Contribution

If you wish to contribute to this project, please read the Contribution Guide first.