🚀 Advanced Trello MCP Server

Enhanced Model Context Protocol Server for Trello integration with Cursor AI
Production-hardened API layer, batch tools, and attachment downloads

TypeScript Trello API MCP Protocol License

📋 Overview

This is an enhanced version of the Trello MCP Server that provides comprehensive integration between Trello and Cursor AI (and similar MCP clients). It includes ~35 tools across boards, lists, cards, labels, and actions, plus a reliable HTTP layer suited to heavy or sequential API use.

✨ Features

🛡️ Reliability (production-tested)

All Trello calls (MCP resources and tools) go through a shared client in src/utils/api.ts:

• HTTPS keep-alive — reuses TLS connections (helps avoid CloudFront / CDN connection churn on burst traffic)
• **fetchWithRetry** — ~60s timeout, exponential backoff with jitter (up to 7 attempts), retries on network errors and 5xx
• Sliding-window rate limit — ~80 requests / 10s (mutex-protected)
• 429 handling — respects Retry-After when present

🎯 API coverage (current)

🔧 Other

• TypeScript + Zod validation on tool inputs
• Batch operations — fewer round-trips for agents (create-cards, move-cards, archive-cards, add-comments, etc.)
• Attachment pipeline — list metadata + optional download to disk (see below)

🚀 Quick Start

Prerequisites

• Node.js 18+
• Trello API Key and Token
• Cursor (or any MCP client)

Installation

1. Clone the repository

 git clone https://github.com/adriangrahldev/advanced-trello-mcp-server.git
 cd advanced-trello-mcp-server

2. Install dependencies

 npm install

3. Build the project

 npm run build

4. Configure environment variables

 export TRELLO_API_KEY="your_api_key"
 export TRELLO_API_TOKEN="your_api_token"

5. Configure Cursor MCP Add to your ~/.cursor/mcp.json (paths adjusted for your machine):

🛠️ Available Tools

📋 Lists (10)

• get-lists — Lists on a board
• create-list / update-list / archive-list
• move-list-to-board
• get-list-actions / get-list-board / get-list-cards
• archive-all-cards-in-list / move-all-cards-in-list