# mcp-server-trello

MCP server connecting AI agents to Trello boards, cards, checklists, and comments. Handles rate limits and acceptance criteria extraction.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 447
- Author: delorenj
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/delorenj/mcp-server-trello
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-server-trello

## What it does

This server exposes 57 tools to inspect and mutate Trello entities. Agents can read card details, manage comments, add URL-based attachments, and export data formatted as Markdown. A dedicated `get_acceptance_criteria` tool pulls acceptance criteria checklists directly into the model context.

Written in TypeScript and built on Bun, the package executes via `bunx` or `npx`. It automatically respects Trello API rate limits of 300 requests per 10 seconds per key and 100 requests per 10 seconds per token. Both `TRELLO_API_KEY` and `TRELLO_TOKEN` are required in the environment before startup.

Workspaces and boards switch dynamically during agent runs with `set_active_board` and `set_active_workspace`. Configuration restarts are not needed. Corporate proxy routing is supported through `https_proxy`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TRELLO_API_KEY`, `TRELLO_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server-trello -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> -- npx -y @delorenj/mcp-server-trello
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server-trello --env TRELLO_API_KEY=<TRELLO_API_KEY> --env TRELLO_TOKEN=<TRELLO_TOKEN> -- npx -y @delorenj/mcp-server-trello
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server-trello": {
            "command": "npx",
            "args": [
                "-y",
                "@delorenj/mcp-server-trello"
            ],
            "env": {
                "TRELLO_API_KEY": "<TRELLO_API_KEY>",
                "TRELLO_TOKEN": "<TRELLO_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server-trello": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@delorenj/mcp-server-trello"
            ],
            "env": {
                "TRELLO_API_KEY": "<TRELLO_API_KEY>",
                "TRELLO_TOKEN": "<TRELLO_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TRELLO_API_KEY=<TRELLO_API_KEY> -e TRELLO_TOKEN=<TRELLO_TOKEN> mcp-server-trello npx -y @delorenj/mcp-server-trello
```
Replace <…> with your own values

## When to use it
- fetch acceptance criteria checklists directly into agent context
- export complete card contents including comments and attachments to Markdown
- create, reorder, and archive lists on active Trello boards
- track board updates by watching cards and lists with `watch_card`

## Example prompts
- Get acceptance criteria checklist for card `CARD_ID` in Trello.
- Create a new list named 'Ready for Review' and move it to position 2.
- Export all comments and attachments for card `TASK-12` in Markdown format.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md