Trello MCP server
io.github.BillNobill/trello-mcp-server·v1.1.0·2 starsTrello Model Context Protocol (MCP) Server for AI Agents
2 stars19 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 (33, 14 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_attachmentAdd a link attachment (URL) to a card.
add_checklistAdd a new checklist to a card. 'items' can be a comma-separated list of item names.
add_commentAdd a comment to a card.
archive_cardArchive a Trello card (sets closed to true).
archive_listArchive a Trello list (sets closed to true).
assign_memberAssign a member to an existing card.
create_cardwrite actionCreate a new card with support for labels, dates and members. Returns the created card JSON object.
create_checkitemwrite actionAdd a new item to an existing checklist.
create_labelwrite actionCreate a new label on a board. Colors: yellow, purple, blue, red, green, orange, black, sky, pink, lime.
create_listwrite actionCreate a new list in a specific board. Returns the created list JSON object.
delete_boardwrite actionPermanently delete a Trello board.
delete_checkitemwrite actionRemove an item from a checklist.
delete_checklistwrite actionRemove a checklist from a card.
get_board_labelsGet all labels defined in a board. Returns a JSON array of label objects (id, name, color).
get_board_membersGet all members of a board. Returns a JSON array of member objects (id, fullName, username).
get_card_detailsFetches full card details including comments, attachments, and checklists. Returns a JSON object.
get_cards_by_dateFilter cards across a board by modification date (since/before). Returns a JSON array.
get_cards_in_listRetrieves all cards within a specific list. Returns a JSON array of cards with basic fields.
get_lists_on_boardFetch only the names and IDs of columns on a board. Returns a JSON array.
get_member_workloadFinds all open cards assigned to a specific member on a board. Returns a JSON array.
list_boardsList all open Trello boards. Returns a JSON array of board objects with 'id' and 'name'.
move_all_cardsBulk Action: Move all cards from one list to another within the same board.
move_cardMove a card to a different list and/or position within a board.
read_boardRead lists and cards from a specific board. Returns a structured JSON object containing all open lists and their cards.
search_cardsPerforms a text-based search for cards across a board. Returns a JSON array of matching cards.
set_custom_fieldSet a text value for a custom field on a card. Requires the Custom Fields Power-Up.
update_cardwrite actionUpdate card details including name, description, labels, dates, and position.
update_card_namewrite actionShorthand to update only a card's name.
update_checkitemwrite actionUpdate an existing check item (rename, state, or position).
update_checklistwrite actionUpdate a checklist header (rename or move).
update_labelwrite actionUpdate a label's name or color.
update_listwrite actionUpdate list details like name or position.
upload_filewrite actionUpload a local file directly to a card as an attachment. Requires an absolute file path.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/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 37 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Trello compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 50% of 1,297 Productivity servers
- Tools
- 33
- the typical Productivity server has 7
- Tools that change things
- 42%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 60% of 852 Productivity servers
- Downloads a week
- 19
- more than 6% of 423 Productivity servers with a package
What its tools let an agent do: 10 read · 8 create · 10 change · 5 delete
Install Trello in Claude Code, Cursor or VS Code
Runs npx -y @billnobill/trello-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add trello-mcp-server -- npx -y @billnobill/trello-mcp-server
What the publisher says
From the Trello repository's README, as published. We do not edit it. Read it on GitHub
🚀 Trello MCP Server: AI-Powered Project Management
Transform your Trello boards into a living workspace for AI agents. This Model Context Protocol (MCP) server allows LLMs (like Gemini, Claude, and GPT-4) to see, organize, and manage your projects with natural language.
🔍 Overview
This project bridges the gap between AI and your Trello workflow. Instead of manually moving cards, you can tell your AI: "Move all 'To Do' cards with the 'Urgent' label to 'In Progress' and assign them to me."
Global Usage: You can save this project anywhere on your computer. Once registered, your AI will be able to start the server automatically whenever needed—no manual terminal execution required.
📋 Prerequisites
- Node.js (v20.0.0 or higher recommended) - Download here
- Git - Download here
- Trello API Key and Token: Get them here
🛠️ Quick Start
1. Installation & Build
# Clone the repository
git clone https://github.com/BillNobill/trello-mcp-server.git
# Install dependencies and build
npm install
npm run build2. Configuration
Create a .env file in the project root (use .env.example as a template):
TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token
TRELLO_BASE_URL=https://api.trello.com/13. Register with your AI client
Claude Code (Recommended)
claude mcp add --scope user trello node "C:\FULL_PATH\TO\trello-mcp-server\dist\index.js"Env vars are read from the .env file or can be passed inline with -e KEY=VALUE flags.
VS Code (GitHub Copilot / Claude extension)
Add to your user settings.json (Ctrl+Shift+P → Open User Settings JSON):
{
"mcp": {
"servers": {
"trello": {
"command": "node",
"args": ["C:\\FULL_PATH\\TO\\trello-mcp-server\\dist\\index.js"],
"env": {
"TRELLO_API_KEY": "your_api_key",
"TRELLO_TOKEN": "your_token",
"TRELLO_BASE_URL": "https://api.trello.com/1"
}
}
}
}
}Cursor
Add to %USERPROFILE%\.cursor\mcp.json:
{
"mcpServers": {
"trello": {
"command": "node",
"args": ["C:\\FULL_PATH\\TO\\trello-mcp-server\\dist\\index.js"],
"env": {
"TRELLO_API_KEY": "your_api_key",
"TRELLO_TOKEN": "your_token",
"TRELLO_BASE_URL": "https://api.trello.com/1"
}
}
}
}[!IMPORTANT]
Always use the absolute path to dist/index.js in the configuration above.
⚡ Available Tools
Your AI agent will automatically "learn" these advanced capabilities:
📋 Board & List Management
- list_boards: List all your Trello boards.
- read_board: Deep dive into lists, cards, labels, and members.
- getlistson_board: Fetch only column names and IDs.
- createlist / updatelist: Manage board columns and their ordering (pos).
- archive_list: Cleanup board structure.
- getboardlabels / getboardmembers: Fetch IDs for precise automation.
- createlabel / updatelabel: Manage board labels (names and colors).
🗂️ Card Operations (Granular & Optimized)
- getcardsin_list: Fetch cards for a specific column.
- getcarddetails: Deep dive into comments, attachments, and checklists for a single card.
- search_cards: Perform fast text-based searches across the entire board.
- createcard / updatecard: Create or modify tasks (name, desc, dates, labels, and pos).
- move_card: Change task status across lists (supports pos).
- moveallcards: Bulk Action to move all cards from one list to another.
- archive_card: Cleanup completed work.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Trello: common questions
- Is Trello MCP server safe?
- Mostly: it is graded B (78/100). Read the Trello safety report
- How do I install Trello?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop 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 74 days ago (2026-08-19). The latest release is v1.1.0.
- How does Trello compare with other Productivity MCP servers?
- safety score 78/100 (higher than 50% of 1,297 Productivity servers); tools 33 (the typical Productivity server has 7); tools that change things 42% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.