Trello MCP server
MCP server for Trello boards with rate limiting, type safety, and comprehensive API integration.
444 stars1.9k downloads/wk
Reviews
Write oneNobody has reviewed Trello yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Trello tools (57, 16 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_card_to_listAdd a new card to a specified list on a specific board
add_cards_to_listAdd multiple cards to a list in one operation. Cards are created sequentially (Trello API does not support batch writes). Rate limiting is handled automatically.
add_checklist_itemAdd a new item to a checklist
add_commentAdd the given text as a new comment to the given card
add_list_to_boardAdd a new list to the specified board
archive_cardwrite actionSend a card to the archive on a specific board
archive_listwrite actionSend a list to the archive on a specific board
assign_member_to_cardAssign a member to a specific card
attach_data_to_cardAttach binary data (image, markdown, PDF, text, etc.) to a card from base64-encoded data or a data URL. Use this for any non-image content. For image/screenshot uploads with PNG defaults, see attach_image_data_to_card.
attach_file_to_cardAttach any file to a card from a URL on a specific board
attach_image_data_to_cardAttach an image to a card from base64 data or a data URL. Image-flavored convenience over attach_data_to_card: defaults assume PNG when mimeType/name are omitted, suitable for screenshot pasting. For non-image content, use attach_data_to_card.
attach_image_to_cardAttach an image to a card from a URL on a specific board
copy_cardCopy/duplicate a Trello card to any list (even on a different board). Copies all properties by default including checklists, attachments, comments, labels, etc.
copy_checklistCopy a checklist (with all its items) from one card to another. Works across different boards.
create_boardwrite actionCreate a new Trello board optionally within a workspace
create_checklistwrite actionCreate a new checklist
create_labelwrite actionCreate a new label on a board
delete_checklist_itemwrite actionDelete a checklist item from a card
delete_commentwrite actionDelete a comment from a Trello card
delete_labelwrite actionDelete a label from a board
download_attachmentDownload an attachment from a card. Returns base64-encoded data that can be saved or viewed.
find_checklist_items_by_descriptionSearch for checklist items containing specific text in their description
get_acceptance_criteriaGet all items from the "Acceptance Criteria" checklist
get_active_board_infoGet information about the currently active board
get_board_custom_fieldsGet all custom field definitions on a board. Returns field IDs, names, and types.
get_board_labelsGet all labels of a specific board
get_board_membersGet all members of a specific board
get_cardGet detailed information about a specific Trello card
get_card_commentsRetrieve all comments from a specific Trello card
get_card_historyGet the history/actions of a specific card
get_cards_by_list_idFetch cards from a specific Trello list on a specific board. Descriptions are previewed by default to keep responses compact; set fields without "desc" to omit descriptions, or increase descMaxLength/omitDescThresholdBytes and use get_card for full details.
get_checklist_by_nameGet a complete checklist with all its items and completion percentage
get_checklist_itemsGet all items from a checklist by name
get_healthget_health_detailedget_health_metadataget_health_performanceget_listsRetrieve all lists from the specified board
get_my_cardsFetch all cards assigned to the current user
get_recent_activityFetch recent activity on the Trello board
list_boardsList all boards the user has access to
list_boards_in_workspaceList all boards in a specific workspace
list_workspacesList workspaces the user has access to. If TRELLO_ALLOWED_WORKSPACES is configured, only allowed workspaces are returned.
move_cardMove a card to a different list, potentially on a different board
perform_system_repairremove_member_from_cardwrite actionRemove a member from a specific card
set_active_boardSet the active board for future operations
set_active_workspaceSet the active workspace for future operations
update_card_custom_fieldwrite actionSet or clear a custom field value on a card. Requires Trello Standard plan or higher.
update_card_detailswrite actionUpdate an existing card's details on a specific board
update_checklist_itemwrite actionUpdate a checklist item name, state, position, due date, reminder, or assigned member
update_commentwrite actionUpdate the given comment with the new text
update_labelwrite actionUpdate an existing label
update_listwrite actionUpdate a list name, archive state, subscription state, or board. Use update_list_position for moving a list within a board.
update_list_positionwrite actionUpdate the position of a list on the board. Trello uses fractional indexing: each list has a float position, and to place a list between two others, use the average of their positions (e.g., between pos 1024 and 2048, use 1536). Use "top"/"bottom" shortcuts to move to the edges.
watch_cardSubscribe or unsubscribe from watching a card for activity notifications
watch_listSubscribe or unsubscribe from watching a list for activity notifications
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumeval / new Function used
exec.evalbuild/index.js: …eCode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
What the publisher says
From the Trello repository's README, as published. We do not edit it. Read it on GitHub
MCP Server Trello
A Model Context Protocol (MCP) server that gives AI agents full access to your Trello boards — cards, lists, checklists, attachments, comments, custom fields, and workspaces — with built-in rate limiting, type safety, and workflow-level tools you won't find in a plain API wrapper, like acceptance-criteria extraction and checklist dependency queries. 57 tools, one npx install, powered by Bun.
Highlights
- Acceptance criteria, natively: getacceptancecriteria pulls a card's AC checklist straight into your agent's context — no competitor offers it.
- Watch anything: watchcard and watchlist route card and list activity into your Trello notifications.
- Full list management: create, update, reorder (updatelistposition), and archive lists.
- Board and workspace switching on the fly: no restarts, no config edits.
- Rate limiting handled for you: respects Trello's API limits automatically (300 req/10s per key, 100 req/10s per token).
- Bun-powered: fast startup and a 2.8-4.4x performance boost over the old Node build. npx and npm work too.
Changelog
For a detailed list of changes, see CHANGELOG.md.
Features
- Full Trello Board Integration: Interact with cards, lists, and board activities
- Acceptance Criteria Extraction: Pull a card's acceptance criteria checklist directly into agent context
- Checklist Intelligence: Query checklist items by name or description, track completion, manage items
- Complete Card Data Extraction: Fetch all card details including checklists, attachments, labels, members, and comments
- 💬 Comment Management: Add, update, delete, and retrieve comments on cards
- Activity Subscriptions: Watch cards and lists so their activity surfaces in Trello notifications
- List Management: Create, update, reorder, and archive lists
- File Attachments: Attach any type of file to cards (PDFs, documents, videos, images, etc.) from URLs
- Custom Fields: Read board custom field definitions and update card values
- Built-in Rate Limiting: Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token)
- Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
- Input Validation: Robust validation for all API inputs
Installation
The server is published on npm as @delorenj/mcp-server-trello. Add it to your MCP client and you're done — no clone, no build.
Quickstart (Claude Desktop, Cursor, and other MCP clients)
Add the server to your client's MCP configuration:
{
"mcpServers": {
"trello": {
"command": "bunx",
"args": ["@delorenj/mcp-server-trello"],
"env": {
"TRELLO_API_KEY": "your-trello-api-key",
"TRELLO_TOKEN": "your-trello-token"
}
}
}
}bunx starts fastest, but npx works identically. Get your API key at trello.com/app-key and generate a token from the same page.
Claude Code
Register the server with the CLI:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
Runs npx -y @delorenj/mcp-server-trello on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-server-trello -- npx -y @delorenj/mcp-server-trello
Trello: common questions
- Is Trello MCP server safe?
- Mostly: it is graded B (75/100). Read the Trello safety report
- How do I install Trello?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Trello need an API key?
- Yes. The registry entry asks for
TRELLO_API_KEY,TRELLO_TOKEN. - Is Trello maintained?
- The last commit was in the last day (2026-09-23). The latest release is v1.8.1.
- What can I use instead of Trello?
- Servers from other publishers that do the same job: Amazing Marvin (complete) MCP server, chat-recall MCP server and DOMShell MCP server. Compare all Trello alternatives.
Alternatives to Trello
Same job from other publishers: the closest match first, then the best rated.
- Amazing Marvin (complete)Amazing Marvin task manager: complete public-API coverage (38 tools) with built-in rate limitingnot reviewedGrowingB
- chat-recallOne searchable history across every AI coding tool, with secret scanning and a shared task board.not reviewedGrowingB
DOMShellDrive Chrome with filesystem commands (ls, cd, grep, click, type). One MCP tool, multi-agent.not reviewedGrowingA- KelviaTask manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.not reviewedGrowingA