agrath/Trello-Desktop-MCP

> 🔀 **Active fork.** This is a maintained fork of kocakli/Trello-Desktop-MCP integrating contributions from across the fork ecosystem (kevinhillinger, zonca, dbz-max, maks244, jantman, ThatIanMcShane, josh-argyle). PRs welcome — see Credits for what each contributor brought in. Published on npm as atlassian-trello-mcp.
A Model Context Protocol (MCP) server for Trello that works with any MCP-compatible client -- Claude Desktop, Claude Code, Gemini CLI, and more.
Provides 50 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search.
Quick Start
1. Get Trello API credentials
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.
1. Visit https://trello.com/power-ups/admin and click **New**.
2. Fill out the **New Power-Up or Integration** form:
- **New Power-Up or Integration name**: Claude MCP. If you have multiple team members, each developer must create their own Power-Up so the API key is tied to their user — name it with your own name too, e.g. Trello MCP Steve.
- **Workspace**: the workspace you want to interact with.
- **Iframe connector URL**: https://localhost (required field, not actually used by this MCP server).
- **Email**: your email.
- **Support contact** and **Author**: can be company-level or personal.
3. Once the Power-Up is created, click **API key** in the sidebar, then **Generate a new API key**, then **Generate API key** in the confirmation modal. Trello displays both an **API key** and a **Secret** — save them somewhere safe.
4. In a browser, visit:
Replace {NAME} with the Power-Up name you chose and {APIKEY} with the key from the previous step. This is an auth prompt — confirm access and click **Allow**. Trello returns an **API token**; copy it.
5. Put the API key and token into your MCP client config (e.g. .claude.json) — see the next section.
2. Install
The easiest path is npx — no clone, no build, just run:
Or install from source:
3. Configure your MCP client
Claude Desktop
Edit your config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Claude Code
Set environment variables TRELLO_API_KEY and TRELLO_TOKEN, or pass credentials per-request.
Gemini CLI
Edit ~/.gemini/settings.json:
Generic MCP client / source install
The server uses stdio transport. Run with environment variables set:
Credentials
Credentials can be provided two ways:
1. **Environment variables** (recommended): Set TRELLO_API_KEY and TRELLO_TOKEN
2. **Per-request**: Pass apiKey and token as tool parameters (overrides env vars)
Available Tools (50)
Boards & Lists
| Tool | Description |
|------|-------------|
| list_boards | List all accessible boards |
| trello_get_user_boards | Get boards with user profile info |
| get_board_details | Board metadata, lists, and optionally cards |
| get_lists | Get all lists on a board |
| trello_filter_lists | Filter lists by name (case-insensitive substring match) |
| trello_create_list | Create a new list on a board |
| trello_update_list | Rename, archive/unarchive, or reposition a list |
| trello_get_board_members | Get all members on a board |
| trello_get_board_labels | Get all labels on a board |
| trello_get_board_cards | Get cards on a board (compact or full); optionally filter by assigned member |
| trello_get_board_custom_fields | Get custom field definitions |
Cards
| Tool | Description |
|------|-------------|
| create_card | Create a card with name, description, due date, labels, members |
| get_card | Get card details |
| trello_get_card_by_number | Find a card by its board-local number (the #N / idShort) |