Trello MCP Server on Cloudflare Workers

A Model Context Protocol (MCP) server that provides comprehensive Trello integration, deployed on Cloudflare Workers with secure authentication.

🚀 Live Deployment

Server URL: https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev

Endpoints:

• SSE Transport: /sse (Server-Sent Events for persistent connections)

• HTTP Transport: /mcp (JSON-RPC over HTTP for simple requests)

Related MCP server: Remote MCP Server

🔧 Features

Trello Operations Supported:

• Boards: List, get, create boards

• Lists: Get lists, create lists

• Cards: Get, create, update, move, delete cards

• Comments: Add and retrieve card comments

• Labels: Manage board labels and card labels

• Members: Manage board members and card assignments

• Checklists: Create checklists and manage checklist items

• Search: Search cards across your Trello workspace

• Attachments: Attach URLs to cards

🔐 Authentication

The server uses secure authentication with environment variables:

Required Environment Variables:

• TRELLO_API_KEY: Your Trello API key (Get it here)

• TRELLO_TOKEN: Your Trello token (Generate here)

• SHARED_SECRET: Shared secret for MCP authentication

Authentication Methods:

1. URL Parameter: ?secret=your_shared_secret

2. Authorization Header: Authorization: Bearer your_shared_secret

📦 Setup & Deployment

Prerequisites:

• Node.js 18+

• Cloudflare account

• Trello API credentials

Local Development:

# Clone the repository
git clone https://github.com/M-Kampmann/trello-mcp-cloudflare.git
cd trello-mcp-cloudflare

# Install dependencies
npm install

# Copy environment variables template
cp .dev.vars.example .dev.vars

# Edit .dev.vars with your actual credentials
# TRELLO_API_KEY=your_api_key
# TRELLO_TOKEN=your_token
# SHARED_SECRET=your_secret

# Start local development server
npm run dev

Deploy to Cloudflare:

# Set production secrets
wrangler secret put TRELLO_API_KEY
wrangler secret put TRELLO_TOKEN
wrangler secret put SHARED_SECRET

# Deploy to Cloudflare Workers
npm run deploy

🔌 Usage Examples

Test Authentication:

# Test with correct secret (should work)
curl "https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=your_secret"

# Test with wrong secret (should return 401)
curl "https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=wrong_secret"

MCP Client Integration:

# Using mcp-remote proxy
npx mcp-remote https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=your_secret

🖥️ Claude Desktop Integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=your_shared_secret"
      ]
    }
  }
}

🛠️ Development

Project Structure:

├── src/
│   └── index.ts          # Main MCP server implementation
├── wrangler.toml         # Cloudflare Workers configuration
├── package.json          # Dependencies and scripts
├── .dev.vars.example     # Environment variables template
└── README.md            # This file

Available Tools:

• listBoards - Get all accessible boards

• getBoard - Get specific board details

• createBoard - Create a new board

• getLists - Get lists from a board

• createList - Create a new list

• getCards - Get cards from a list

• getBoardCards - Get all cards from a board

• getCard - Get specific card details

• createCard - Create a new card

• updateCard - Update card properties

• moveCard - Move card between lists

• deleteCard - Delete a card

• addComment - Add comment to card

• getComments - Get card comments

• addLabel - Add label to card

• removeLabel - Remove label from card

• getBoardLabels - Get board labels

• createLabel - Create new label

• addMemberToCard - Assign member to card

• removeMemberFromCard - Remove member from card

• getBoardMembers - Get board members

• createChecklist - Create checklist on card

• addChecklistItem - Add item to checklist

• getCardChecklists - Get card checklists

• searchCards - Search cards by query

• attachUrlToCard - Attach URL to card

• getCurrentUser - Get current user info

• archiveListCards - Archive all cards in list

🔒 Security

• All API credentials are stored as Cloudflare Workers secrets

• Authentication required for all endpoints

• CORS properly configured for web clients

• No sensitive data exposed in logs

📝 License

MIT License - see LICENSE file for details

🤝 Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Test thoroughly

5. Submit a pull request

🐛 Troubleshooting

Common Issues:

Authentication Errors:

• Verify your SHARED_SECRET is set correctly

• Check that Trello API credentials are valid

• Ensure you're using the correct URL parameter format

Connection Issues:

• Verify the server URL is accessible

• Check that CORS headers are properly set

• Test with curl first before using MCP clients

Deployment Issues:

• Ensure all secrets are set in Cloudflare Workers

• Check wrangler.toml configuration

• Verify Node.js compatibility settings

For more help, check the Cloudflare Workers documentation or MCP specification.