delorenj/mcp-server-trello

A Model Context Protocol (MCP) server that gives AI agents full access to your Trello boards — cards, lists, checklists, attachments, comments, custom fields, and workspaces — with built-in rate limiting, type safety, and workflow-level tools you won't find in a plain API wrapper, like acceptance-criteria extraction and checklist dependency queries. 57 tools, one npx install, powered by Bun.
## Highlights
Acceptance criteria, natively: getacceptancecriteria pulls a card's AC checklist straight into your agent's context — no competitor offers it.
Watch anything: watchcard and watchlist route card and list activity into your Trello notifications.
Full list management: create, update, reorder (updatelistposition), and archive lists.
Board and workspace switching on the fly: no restarts, no config edits.
Rate limiting handled for you: respects Trello's API limits automatically (300 req/10s per key, 100 req/10s per token).
Bun-powered: fast startup and a 2.8-4.4x performance boost over the old Node build. npx and npm work too.
## Changelog
For a detailed list of changes, see CHANGELOG.md.
## Features
Full Trello Board Integration: Interact with cards, lists, and board activities
Acceptance Criteria Extraction: Pull a card's acceptance criteria checklist directly into agent context
Checklist Intelligence: Query checklist items by name or description, track completion, manage items
Complete Card Data Extraction: Fetch all card details including checklists, attachments, labels, members, and comments
💬 Comment Management: Add, update, delete, and retrieve comments on cards
Activity Subscriptions: Watch cards and lists so their activity surfaces in Trello notifications
List Management: Create, update, reorder, and archive lists
File Attachments: Attach any type of file to cards (PDFs, documents, videos, images, etc.) from URLs
Custom Fields: Read board custom field definitions and update card values
Built-in Rate Limiting: Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token)
Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
Input Validation: Robust validation for all API inputs
Error Handling: Graceful error handling with informative messages
Dynamic Board Selection: Switch between boards and workspaces without restarting
Markdown Formatting: Export card data in human-readable markdown format
## Installation
The server is published on npm as @delorenj/mcp-server-trello. Add it to your MCP client and you're done — no clone, no build.
### Quickstart (Claude Desktop, Cursor, and other MCP clients)
Add the server to your client's MCP configuration:
json
"mcpServers": {
"trello": {
"command": "bunx",
"args": ["@delorenj/mcp-server-trello"],
"env": {
"TRELLOAPIKEY": "your-trello-api-key",
"TRELLOTOKEN": "your-trello-token"
bunx starts fastest, but npx works identically. Get your API key at trello.com/app-key and generate a token from the same page.
### Claude Code
Register the server with the CLI:
bash
claude mcp add trello \
--env TRELLOAPIKEY=your-trello-api-key \
--env TRELLOTOKEN=your-trello-token \
-- bunx @delorenj/mcp-server-trello
### MCP Registry
The server is listed on the official MCP Registry as io.github.delorenj/mcp-server-trello, so registry-aware clients can discover and install it directly.