MCP Server Trello
This MCP server exposes 31 typed tools to read and write Trello data across cards, lists, boards, workspaces, checklists, attachments, members, labels, comments, and activity, with rate limiting, validation, and a local CLI.
Cards: add, update, move, archive, fetch, get your cards, attach images, add comments, assign/unassign members.
Lists: get lists, add list, archive list.
Boards: list boards, set active board, get active board info, get board labels, get board members, get recent activity.
Workspaces: list workspaces, set active workspace, list boards in workspace.
Checklists: get items, add item, find items by description, get acceptance criteria, get checklist by name.
Attachments: list attachments, download attachment, delete attachment.
State: set active board/workspace; most board-scoped tools use active/default board if not specified.
Rate limiting: queued token bucket for Trello limits (300/10s per key, 100/10s per token).
CLI:
trellobinary for local agent/terminal workflows.Validation: Zod input validation and TypeScript declarations.
Enables AI agents to manage Trello boards, lists, cards, checklists, attachments, activity, and workspace navigation through 23 typed tools.
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., "@MCP Server Trello List my Trello boards"
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.
mcp-trello
Model Context Protocol (MCP) server and local CLI for Trello. It exposes 31 typed tools for boards, lists, cards, checklists, activity, and workspace navigation, with Trello-aware rate limiting and validation built in.
This repository is maintained as ftaricano/mcp-trello (formerly ftaricano/mcp-server-trello). It is derived from MIT-licensed original work by Jarad DeLorenzo, with original copyright preserved and current ownership/provenance documented in NOTICE.md.
Highlights
31 MCP tools for cards, lists, boards, workspaces, checklists, attachments, and activity.
Multi-board and workspace support with persisted active board/workspace state.
Trello API rate limiting for the documented per-key and per-token limits.
Zod input validation and TypeScript declarations in the published package.
trelloCLI for local agent workflows.CI on Node.js 20 and 22 for lint, typecheck, tests, build, and
npm pack --dry-run.
Related MCP server: Trello MCP Server
Requirements
Node.js 20 or newer.
A Trello API key from https://trello.com/app-key.
A Trello token created from that API key.
Install
Use the package directly from npm-compatible MCP clients:
{
"mcpServers": {
"trello": {
"command": "npx",
"args": ["-y", "@ftaricano/mcp-trello"],
"env": {
"TRELLO_API_KEY": "replace_with_trello_api_key",
"TRELLO_TOKEN": "replace_with_trello_token"
}
}
}
}With pnpx:
{
"mcpServers": {
"trello": {
"command": "pnpx",
"args": ["@ftaricano/mcp-trello"],
"env": {
"TRELLO_API_KEY": "replace_with_trello_api_key",
"TRELLO_TOKEN": "replace_with_trello_token"
}
}
}
}Global install is also supported:
npm install -g @ftaricano/mcp-trello
mcp-trelloTrello Token
Create a Trello token by visiting this URL after replacing the app name and API key:
https://trello.com/1/authorize?expiration=never&name=YOUR_APP_NAME&scope=read,write&response_type=token&key=YOUR_API_KEYUse expiration=30days or another shorter value when your operating model can tolerate periodic token renewal. Treat the token like a password.
Configuration
The server reads credentials from environment variables:
TRELLO_API_KEY=replace_with_trello_api_key
TRELLO_TOKEN=replace_with_trello_token
# Optional defaults. These can also be changed at runtime by MCP tools.
TRELLO_BOARD_ID=
TRELLO_WORKSPACE_ID=The CLI also loads a .env file from the current working directory and can read credentials from the macOS Keychain when TRELLO_KEYCHAIN_PREFIX is set:
security add-generic-password -s TRELLO_API_KEY -a "$USER" -w "replace_with_trello_api_key"
security add-generic-password -s TRELLO_TOKEN -a "$USER" -w "replace_with_trello_token"
export TRELLO_KEYCHAIN_PREFIX=TRELLO
trello list-boards --mdCredential resolution order for the CLI:
Process environment.
.envfile in the current working directory.macOS Keychain entries named
<PREFIX>_API_KEY,<PREFIX>_TOKEN, and optionally<PREFIX>_BOARD_ID.
Tools
Card tools:
add_card_to_listupdate_card_detailsarchive_cardmove_cardget_cardget_cards_by_list_idget_my_cardsattach_image_to_card
List, board, and workspace tools:
get_listsadd_list_to_boardarchive_listlist_boardsset_active_boardlist_workspacesset_active_workspacelist_boards_in_workspaceget_active_board_infoget_recent_activity
Checklist tools:
get_checklist_itemsadd_checklist_itemfind_checklist_items_by_descriptionget_acceptance_criteriaget_checklist_by_name
Most board-scoped tools accept an optional boardId. If omitted, the configured or persisted active board is used.
CLI
The package installs a trello binary for local agent and terminal workflows.
trello list-boards --md
trello set-board <boardId>
trello active-board --md
trello lists --md
trello board labels --md
trello board members --md
trello card add <listId> "Task name" --desc "details" --due 2026-05-01T12:00:00Z
trello card update <cardId> --name "Renamed" --done
trello card move <cardId> <listId>
trello card get <cardId> --md
trello card archive <cardId>
trello card comment <cardId> "Status update"
trello card attach <cardId> https://example.com/cover.png --name "Cover"
trello card assign <cardId> <memberId>
trello card unassign <cardId> <memberId>
trello cards mine --md
trello cards list <listId> --mdDefault output is JSON for agent consumption. Add --md for markdown output. Exit codes are 0 for success, 1 for missing config or validation errors, and 2 for Trello API errors.
Date Formats
dueDate: full ISO 8601 timestamp, for example2026-05-01T12:00:00Z.start: date only, for example2026-05-01.
Rate Limiting
Requests are queued through a token bucket limiter for Trello's published API limits:
300 requests per 10 seconds per API key.
100 requests per 10 seconds per token.
Development
git clone https://github.com/ftaricano/mcp-trello.git
cd mcp-trello
SKIP_PREPARE=true npm install
cp .env.example .envUseful commands:
npm run lint
npm run typecheck
npm test
npm run build
npm pack --dry-runSecurity
Do not commit real Trello credentials, .env files, local logs, generated databases, or machine-specific agent configuration. See SECURITY.md for supported reporting channels and credential rotation guidance.
Contributing
Before opening a PR, run:
npm run lint
npm run typecheck
npm test
npm run build
npm pack --dry-runKeep changes focused and include tests for behavior changes.
Provenance
This project started as a fork of delorenj/mcp-server-trello. Credit for the original MCP server scaffolding, base Trello API integration, and initial tool surface belongs to Jarad DeLorenzo.
This repository is maintained under ftaricano/mcp-trello. Additions include the trello CLI binary, macOS Keychain credential resolution, expanded CLI card/board/list coverage, 152 unit tests, CI on Node.js 20/22, package metadata ownership, security documentation, and npm pack hardening.
See NOTICE.md for the provenance statement.
Acknowledgments
Original MCP server by Jarad DeLorenzo (delorenj/mcp-server-trello)
Built with the Model Context Protocol SDK
Uses the Trello REST API
License
MIT. See LICENSE.
Available Tools
31 toolsadd_card_to_listAdd Card to ListA
Add a new card to a specified list on a specific board
Inputs: name (required), listId (required), start, labels, +3 more.
add_checklist_itemAdd Checklist ItemC
Add a new item to a checklist
Inputs: text (required), checkListName (required), boardId.
add_commentAdd CommentA
Add a comment to a card
Inputs: text (required), cardId (required).
add_list_to_boardAdd List to BoardB
Add a new list to the specified board
Inputs: name (required), boardId.
archive_cardArchive CardB
Send a card to the archive on a specific board
Inputs: cardId (required), boardId.
archive_listArchive ListB
Send a list to the archive on a specific board
Inputs: listId (required), boardId.
assign_memberAssign MemberB
Assign a member to a card
Inputs: cardId (required), memberId (required).
attach_image_to_cardAttach Image to CardA
Attach an image (or any file) to a card from a URL on a specific board
Inputs: cardId (required), imageUrl (required), name, boardId.
delete_attachmentDelete AttachmentB
Remove an attachment from a card
Inputs: cardId (required), attachmentId (required).
download_attachmentDownload AttachmentA
Download the binary content of a card attachment. Trello-hosted attachments on private boards require authentication that a plain URL fetch lacks (401) — this tool sends the correct credentials. Returns an image block for images, otherwise base64 + metadata.
Inputs: cardId (required), attachmentId (required), maxBytes.
find_checklist_items_by_descriptionFind Checklist Items by DescriptionC
Search for checklist items containing specific text in their description
Inputs: description (required), boardId.
get_acceptance_criteriaGet Acceptance CriteriaB
Get all items from the "Acceptance Criteria" checklist
Inputs: boardId.
get_active_board_infoGet Active Board InfoB
Get information about the currently active board
Inputs: no named parameters.
get_board_labelsGet Board LabelsA
List all labels defined on a board
Inputs: boardId.
get_board_membersGet Board MembersA
List all members of a board
Inputs: boardId.
get_cardGet CardA
Get detailed information about a specific Trello card
Inputs: cardId (required), includeMarkdown.
get_card_attachmentsGet Card AttachmentsA
List all attachments on a card (metadata: id, name, url, fileName, mimeType, bytes). Use download_attachment to fetch the actual file content.
Inputs: cardId (required).
get_cards_by_list_idGet Cards by List IDB
Fetch cards from a specific Trello list on a specific board
Inputs: listId (required), boardId.
get_checklist_by_nameGet Checklist by NameA
Get a complete checklist with all its items and completion percentage
Inputs: name (required), boardId.
get_checklist_itemsGet Checklist ItemsA
Get all items from a checklist by name
Inputs: name (required), boardId.
get_listsGet ListsA
Retrieve all lists from the specified board
Inputs: boardId.
get_my_cardsGet My CardsA
Fetch all cards assigned to the current user
Inputs: no named parameters.
get_recent_activityGet Recent ActivityB
Fetch recent activity on the Trello board
Inputs: limit, boardId.
list_boardsList BoardsA
List all boards the user has access to
Inputs: no named parameters.
list_boards_in_workspaceList Boards in WorkspaceA
List all boards in a specific workspace
Inputs: workspaceId (required).
list_workspacesList WorkspacesA
List all workspaces the user has access to
Inputs: no named parameters.
move_cardMove CardB
Move a card to a different list, potentially on a different board
Inputs: cardId (required), listId (required), boardId.
set_active_boardSet Active BoardA
Set the active board for future operations
Inputs: boardId (required).
set_active_workspaceSet Active WorkspaceA
Set the active workspace for future operations
Inputs: workspaceId (required).
unassign_memberUnassign MemberA
Remove a member from a card
Inputs: cardId (required), memberId (required).
update_card_detailsUpdate Card DetailsB
Update an existing card's details on a specific board
Inputs: cardId (required), name, start, labels, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 31 tools
Most tools have distinct resource-action pairs, but the checklist retrieval cluster (get_checklist_items, get_checklist_by_name, get_acceptance_criteria) overlaps significantly, and list_boards vs list_boards_in_workspace adds minor confusion. Descriptions help but boundaries are not always clear.
All tool names consistently use snake_case with verb-first patterns (add_, get_, list_, set_, etc.). The naming convention is uniform and predictable across all 31 tools.
31 tools is above the 25-tool threshold and includes several redundant checklist retrieval tools and overlapping board-listing tools. The count feels excessive for the actual distinct operations offered.
The surface covers many card, list, and attachment operations, but lacks board creation/deletion, label assignment, comment retrieval, checklist creation, and card deletion (only archive). These gaps will force agents to work around missing functionality.
Maintenance
Related MCP Connectors
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Trello boards through comprehensive card, list, and board management tools. Includes built-in rate limiting, type safety, and support for operations like creating cards, updating details, managing members, and tracking board activity.213 npm10MIT
- AlicenseBqualityDmaintenanceProvides tools for managing Trello boards, lists, and cards via natural language. Supports dynamic board and workspace selection, rate limiting, and type-safe API integration.25309 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to inspect and update Trello boards via the Trello REST API, supporting actions like reading boards, lists, cards, and performing CRUD operations on cards and checklists.15384 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Trello boards through MCP tools, including listing tasks, moving cards, commenting, labeling, and managing attachments.1MIT