Atlassian Trello MCP

🔀Active fork.This is a maintained fork ofkocakli/Trello-Desktop-MCPintegrating contributions from across the fork ecosystem (kevinhillinger,zonca,dbz-max,maks244,jantman,ThatIanMcShane,josh-argyle). PRs welcome — seeCreditsfor what each contributor brought in. Published on npm asatlassian-trello-mcp.

Trello no longer hands out API keys directly — each user must create their own Power-Up, then mint a token against that Power-Up's key.
- Visithttps://trello.com/power-ups/adminand clickNew.
- Fill out theNew Power-Up or Integrationform:

https://trello.com/1/authorize?expiration=never&scope=read,write,account&response_type=token&name={NAME}&key={APIKEY}

git clone https://github.com/agrath/Trello-Desktop-MCP.git cd Trello-Desktop-MCP npm install npm run build

{ "mcpServers": { "trello": { "command": "npx", "args": ["-y", "atlassian-trello-mcp"], "env": { "TRELLO_API_KEY": "your-api-key", "TRELLO_TOKEN": "your-token" } } } }

claude mcp add trello -- npx -y atlassian-trello-mcp

Set environment variablesTRELLO_API_KEYandTRELLO_TOKEN, or pass credentials per-request.

{ "mcpServers": { "trello": { "command": "npx", "args": ["-y", "atlassian-trello-mcp"], "env": { "TRELLO_API_KEY": "your-api-key", "TRELLO_TOKEN": "your-token" } } } }

The server uses stdio transport. Run with environment variables set:

TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token npx atlassian-trello-mcp # or, from a source clone: TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token node dist/index.js

- Environment variables(recommended): SetTRELLO_API_KEYandTRELLO_TOKEN
- Per-request: PassapiKeyandtokenas tool parameters (overrides env vars)

SetTRELLO_READ_ONLY=trueto disable all write operations. Only read/query tools will be available.

{ "env": { "TRELLO_API_KEY": "your-key", "TRELLO_TOKEN": "your-token", "TRELLO_READ_ONLY": "true" } }

Several tools support acompactparameter (default:true) that returns minimal fields to reduce response size. Setcompact: falsefor full details including descriptions, labels, members, and custom fields.

Tools with compact mode:get_board_details,trello_get_board_cards,trello_get_list_cards,trello_search.

Whenget_cardis called and the card has image attachments, the server downloads them and returns them as inline MCP image content blocks alongside the JSON — letting the client see card images directly. Downloads are restricted to Trello-hosted URLs (.trello.com,trello-attachments.s3.amazonaws.com) and capped at 5 MB per image to mitigate SSRF and payload-bloat risks.

src/ index.ts Entry point (credential injection, tool routing) server.ts MCP server factory (read-only mode support) tools/ boards.ts Board tools (list, details, lists, filter) cards.ts Card tools (CRUD, archive) lists.ts List tools (cards, create list, comments) members.ts Member tools (user boards, member details) search.ts Search tool advanced.ts Labels, attachments, members on cards, custom fields checklists.ts Checklist and check item tools (13 tools) trello/ client.ts TrelloClient (API calls, retry, rate limiting) types/ trello.ts TypeScript interfaces utils/ validation.ts Zod schemas, extractCredentials, extractTrelloId logger.ts Pino file logger health.ts Health check utility appInsights.ts Telemetry (no-op) tests/ validation.test.ts Validation and credential extraction tests trelloClient.test.ts API client tests (mocked fetch) tools.test.ts Tool handler tests (mocked client)

npm install npm run build npm test npm run type-check

- ID resolution: All tools accept Trello URLs, short IDs, or full 24-char hex IDs viaextractTrelloId()
- Credential fallback:extractCredentials()checks args first, then env vars
- Retry with backoff: TrelloClient retries on 500/network errors (3 attempts, exponential backoff)
- Rate limiting: Extracts and returnsx-rate-limit-headers from every response
- Validation: Zod schemas validate all inputs before API calls

Pull requests are welcome and actively reviewed. This fork is maintained by an extensive Trello user, so features get real-world testing.

If you've forked the original project and built something useful, please submit a PR here rather than maintaining a separate fork -- it's easier for everyone to benefit from a single well-maintained project.
- Fork this repo
- Create a feature branch
- Add tests for new functionality
- Runnpm testandnpm run build
- Submit a pull request with a clear description of what and why

This project is a fork ofkocakli/Trello-Desktop-MCP. Features and ideas were incorporated from across the fork ecosystem:

- kocakli-- Original project, MCP client-agnostic rebranding, stderr logging fix
- kevinhillinger-- Credential injection architecture, label deletion, card member management, card archiving, expanded TypeScript types, resources layer
- zonca-- Centralized credential handling with env var fallback, label management tools, comprehensive unit tests, improved TypeScript types replacingany
- dbz-max-- Custom fields support (board custom fields + card custom field items)
- maks244-- Read-only mode concept, list filtering by name, credential stripping from telemetry logs
- jantman-- Fix for numericposvalues rejected when sent as strings by MCP clients
- ThatIanMcShane-- Bumped@modelcontextprotocol/sdk1.0.4 → 1.29.0 to fix connection timeouts with current Claude Code releases
- josh-argyle-- Auto-download image attachments inget_cardresponses as inline MCP image content blocks (with allowlist + size cap added during port)

From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.