trello-mcp
Provides tools for interacting with Trello boards, lists, cards, checklists, and comments, enabling AI agents to manage project workflows with per-project board configuration.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@trello-mcp Show my project overview"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
trello-mcp
A Model Context Protocol server for Trello — connect AI agents to your boards with per-project configuration and credentials that stay on your machine.
Works with Cursor, Claude Desktop, VS Code Copilot, and any MCP-compatible client.
Quick setup for AI agents
Paste this one line into Cursor, Claude Code, Codex, Grok, or any agent that can fetch URLs:
Fetch https://raw.githubusercontent.com/asim-altayb/trello-mcp/main/docs/agent-setup/prompt.md and follow every step to install trello-mcp and wire it to this project.The agent will detect your OS (Linux, macOS, or Windows), clone the server, configure credentials, write .trello-mcp.json, and register MCP — without you running terminal commands.
See AGENTS.md and docs/agent-setup/prompt.md for details.
Related MCP server: Advanced Trello MCP Server
Why use this?
Most Trello MCP integrations focus on hosted OAuth or a single global board. This server is built for developers who juggle multiple codebases and want:
Local access — your API key + token, stored locally in
.envPer-project boards — each repo declares which Trello boards belong to it
Board aliases — reference
sprintorbackloginstead of raw board IDsAgent-ready output — JSON or Markdown responses
Comparison
Feature | trello-mcp | Atlassian Trello MCP |
|
Auth | API token (local) | Cloud OAuth | API token |
Per-repo board profiles |
| One workspace | Global config |
Board aliases | Yes | No | No |
Markdown output | Yes | N/A | Yes |
Checklists + comments | Yes | Partial | Yes |
Rate limiting | Built-in | Hosted | Built-in |
Best for | Multi-project workflows | Team OAuth setups | Full-featured installs |
Quick start
1. Clone and configure credentials
git clone https://github.com/asim-altayb/trello-mcp.git
cd trello-mcp
npm install
npm run setup
npm run buildnpm run setup saves TRELLO_API_KEY and TRELLO_TOKEN to .env.
Get credentials from Trello Power-Up Admin → API Key tab.
2. Pin boards to a project
From any project directory:
TRELLO_PROJECT_ROOT=/path/to/your/project npm run init-projectThis writes .trello-mcp.json:
{
"name": "my-app",
"boards": [
{ "id": "abc123", "name": "Sprint Board", "alias": "sprint", "default": true },
{ "id": "def456", "name": "Backlog", "alias": "backlog" }
]
}Safe to commit — board IDs only, no secrets.
3. Connect your AI client
Add to .mcp.json (Cursor / Claude Code) or your client's MCP config:
{
"mcpServers": {
"trello-mcp": {
"command": "node",
"args": ["/absolute/path/to/trello-mcp/dist/index.js"],
"cwd": "/absolute/path/to/your/project"
}
}
}Restart the client after saving.
See mcp-config.example.json for a copy-paste template.
Example prompts
"Show my project Trello overview"
"What's on the sprint board?"
"Search for auth bug in this project's boards"
"Create a card: Fix webhook retry"
"Mark the first checklist item complete on card X"
Tools
Project context
Tool | Description |
| Active project, configured boards, default board |
| All project boards → lists → cards |
Boards & lists
Tool | Description |
| Project boards (or all with |
| Board with lists and cards |
| Lists on a board |
| Recent board activity |
| Create a list |
Cards
Tool | Description |
| Cards assigned to you |
| Full card details |
| Cards in a list |
| Create a card |
| Update card fields / labels |
| Move card to another list |
| Archive a card |
| Search cards/boards |
Checklists & comments
Tool | Description |
| Add checklist to card |
| Add checklist item |
| Update text or completion |
| Delete checklist item |
| Add comment |
| List comments |
| Edit comment |
| Delete comment |
Board tools accept optional board (ID, alias, or name). When omitted, the project default is used.
Multi-project setup
One shared server install; each repo gets its own .trello-mcp.json:
OS | Shared server + |
Linux / macOS |
|
Windows |
|
SERVER_DIR/ → .env (credentials, once)
~/project-a/ → .trello-mcp.json (boards 1, 2)
~/project-b/ → .trello-mcp.json (boards 3, 4)Point each project's MCP config cwd at that project. The server picks up the right boards automatically.
Security
Never commit
.env— it contains your API token.trello-mcp.jsonis safe to commit (board IDs only)Revoke tokens anytime: Trello → Account → Applications
Development
npm run build
npm test
npm run devContributing
Issues and PRs are welcome. See CONTRIBUTING.md.
License
MIT — see LICENSE.
Available Tools
24 toolstrello_add_checklistC
Add a checklist to a card.
Inputs: name (required), cardId (required).
trello_add_checklist_itemC
Add an item to a checklist.
Inputs: text (required), cardId (required), checklistId (required).
trello_add_commentC
Add a comment to a card.
Inputs: text (required), cardId (required).
trello_add_listC
Add a new list to a board.
Inputs: name (required), board.
trello_archive_cardC
Archive a card.
Inputs: cardId (required).
trello_create_cardC
Create a new card in a list.
Inputs: name (required), listId (required), due, pos, +3 more.
trello_delete_checklist_itemC
Delete a checklist item.
Inputs: cardId (required), checkItemId (required).
trello_delete_commentC
Delete a comment.
Inputs: commentId (required).
trello_get_boardA
Get a board with open lists and cards. Uses project default board when board is omitted.
Inputs: board, format.
trello_get_cardB
Get full card details including comments, checklists, members, and attachments.
Inputs: cardId (required), format.
trello_get_card_commentsA
Get comments on a card without fetching full card data.
Inputs: cardId (required), limit.
trello_get_cards_in_listC
Get open cards in a list.
Inputs: listId (required).
trello_get_meA
Verify your Trello connection and return the authenticated member profile.
Inputs: no named parameters.
trello_get_my_cardsB
List cards assigned to you. Optionally scoped to project boards.
Inputs: projectOnly.
trello_get_recent_activityB
Fetch recent activity on a board.
Inputs: board, limit.
trello_list_boardsB
List boards for the current context. With project config, returns only boards selected for this project.
Inputs: format, allBoards.
trello_list_listsA
List open lists on a board.
Inputs: board.
trello_move_cardC
Move a card to another list.
Inputs: cardId (required), listId (required).
trello_project_infoA
Show the active project, configured boards, aliases, and default board from .trello-mcp.json.
Inputs: no named parameters.
trello_project_overviewB
Dashboard view of all boards configured for this project, including lists and card titles.
Inputs: format.
trello_searchC
Search cards and boards. Scoped to project boards by default when configured.
Inputs: query (required), board, allProjectBoards.
trello_update_cardB
Update a card (name, description, due date, labels, list, archive state).
Inputs: cardId (required), due, desc, name, +5 more.
trello_update_checklist_itemC
Update a checklist item (text or completion state).
Inputs: cardId (required), checkItemId (required), text, complete.
trello_update_commentC
Update an existing comment.
Inputs: text (required), commentId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Each tool targets a distinct action or resource: get, list, create, update, delete, move, search, etc. There is no overlap; even similar tools like get_card and get_card_comments are clearly differentiated by purpose.
All tools follow the consistent pattern trello_{verb}_{noun} (e.g., trello_add_checklist, trello_get_card, trello_list_boards). No mixed conventions or unclear abbreviations.
24 tools is on the higher side but justified given the breadth of Trello's API (boards, lists, cards, checklists, comments, search, project config). Each tool serves a clear purpose, though some could be combined.
Covers core CRUD operations for boards, lists, cards, checklists, and comments, plus search and project management. Missing board creation/deletion, but these are less common in typical MCP workflows.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.35MIT
- AlicenseDqualityCmaintenanceAn enhanced Model Context Protocol server providing comprehensive integration between Trello and Cursor AI with 40+ tools covering multiple Trello API categories for complete project management.3211MIT
- AlicenseAqualityDmaintenanceA Trello MCP server that enables AI assistants to manage boards, cards, and lists via the Model Context Protocol.2537 PyPI2MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that connects Trello to Claude Code. Manage your boards, lists, cards, checklists, and more — all through natural language.73384 npm1MIT