fastmcp-trello
Allows managing Trello boards, cards, lists, labels, attachments, and comments programmatically through the Trello API.
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., "@fastmcp-trello Create a card called 'Fix login bug' in the To Do list on my Project board"
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.
A Trello MCP server — manage boards, cards, and lists from any AI assistant that supports the Model Context Protocol. MCP is an open standard that lets AI assistants like Claude, Cursor, and Copilot interact with external tools and services.
Trello MCP Tools
Tool | Description |
| List all boards accessible to you |
| Get a board's details including its lists |
| Get all open lists on a board |
| Create a new board |
| Update a board's name or description |
| Close (archive) a board |
| Get all cards in a list |
| Get full details for a card including comments |
| Create a new card on a list |
| Update a card's fields or move it to a different list |
| Archive (close) a card |
| Get all labels defined on a board |
| Create a new label on a board |
| Delete a label from a board |
| Add a label to a card |
| Remove a label from a card |
| Create a new list on a board |
| Rename a list |
| Archive (close) a list |
| Move a list to a new position |
| Get all attachments on a card |
| Add a URL attachment to a card |
| Delete an attachment from a card |
| Add a comment to a card |
| Search for cards across boards, optionally scoped to a specific board |
Related MCP server: Trello MCP Server
Prerequisites
You need a Trello API key and token:
Go to the Trello Power-Ups admin page
Create a new Power-Up (any name/workspace will do)
Generate a new API key
From the API key page, click the Token link to generate a token
Installation
Add the following to your MCP client configuration (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"trello": {
"command": "uvx",
"args": ["fastmcp-trello"],
"env": {
"TRELLO_API_KEY": "your-api-key",
"TRELLO_TOKEN": "your-token"
}
}
}
}Or run standalone:
TRELLO_API_KEY=your-api-key TRELLO_TOKEN=your-token uvx fastmcp-trelloUsage
Once installed in your MCP client, you can ask your AI assistant things like:
"Show me all my Trello boards"
"Create a card called 'Fix login bug' in the To Do list on my Project board"
Configuration
Variable | Required | Description |
| Yes | Your Trello API key |
| Yes | Your Trello authentication token |
Development
git clone https://github.com/Jimdrews/fastmcp-trello.git
cd fastmcp-trello
uv sync --group dev
uv run pytestSee CONTRIBUTING.md for more details.
License
Available Tools
25 toolsadd_attachmentA
Add a URL attachment to a card. Only URLs are supported (no file uploads).
Inputs: url (required), card_id (required), name. Returns: result
add_commentB
Add a comment to a card.
Inputs: text (required), card_id (required). Returns: result
add_label_to_cardC
Add a label to a card.
Inputs: card_id (required), label_id (required). Returns: result
archive_cardB
Archive (close) a card.
Inputs: card_id (required). Returns: result
archive_listB
Archive (close) a list.
Inputs: list_id (required). Returns: result
close_boardA
Close (archive) a board. This does not permanently delete it.
Inputs: board_id (required). Returns: result
create_boardA
Create a new board. Set default_lists=false for a blank board.
Inputs: name (required), description, default_lists. Returns: result
create_cardA
Create a new card on a list.
Set position to "top", "bottom", or a positive float to control placement.
Inputs: name (required), list_id (required), due, position, +1 more. Returns: result
create_labelB
Create a new label on a board.
Inputs: name (required), board_id (required), color. Returns: result
create_listB
Create a new list on a board. Position can be 'top', 'bottom', or a number.
Inputs: name (required), board_id (required), position. Returns: result
delete_attachmentB
Delete an attachment from a card.
Inputs: card_id (required), attachment_id (required). Returns: result
delete_labelC
Delete a label from a board.
Inputs: label_id (required). Returns: result
get_attachmentsB
Get all attachments on a card.
Inputs: card_id (required). Returns: result
get_boardB
Get a board's details including its lists.
Inputs: board_id (required). Returns: result
get_boardsA
List all boards accessible to you.
Inputs: no named parameters. Returns: result
get_cardA
Get full details for a card including comments.
Inputs: card_id (required). Returns: result
get_cardsB
Get all cards in a list.
Inputs: list_id (required). Returns: result
get_labelsB
Get all labels defined on a board.
Inputs: board_id (required). Returns: result
get_listsA
Get all open lists on a board.
Inputs: board_id (required). Returns: result
move_listA
Move a list to a new position. Use 'top', 'bottom', or a number.
Inputs: list_id (required), position (required). Returns: result
remove_label_from_cardB
Remove a label from a card.
Inputs: card_id (required), label_id (required). Returns: result
search_cardsA
Search for cards across boards. Optionally scope to a specific board.
Inputs: query (required), board_id. Returns: result
update_boardB
Update a board's name or description.
Inputs: board_id (required), name, description. Returns: result
update_cardA
Update a card's fields.
Set list_id to move the card to a different list. Set position to "top", "bottom", or a positive float to reorder within the list.
Inputs: card_id (required), due, name, list_id, +2 more. Returns: result
update_listC
Rename a list.
Inputs: name (required), list_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Every tool targets a specific resource and action (e.g., get_boards vs get_board vs get_cards), making them easy to distinguish. Even similar operations like archive_card and close_board are clearly separated by resource type.
All tools follow a consistent verb_noun pattern with lowercase snake_case (e.g., create_board, update_card, add_attachment). No mixed conventions or vague verbs.
With 25 tools, the set feels heavy, though the breadth of Trello resources (boards, lists, cards, labels, attachments, comments) provides some justification. It sits at the top of the borderline range.
The set provides solid CRUD coverage for boards, lists, cards, labels, and attachments, plus comments and search. Minor gaps include label updates, member assignment, and permanent deletion (only archiving is available), but these are not critical.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- FlicenseAqualityDmaintenanceA powerful MCP server for interacting with Trello boards, lists, and cards via AI Hosts.2254-
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that connects Trello to Claude Code. Manage your boards, lists, cards, checklists, and more — all through natural language.73255 npm1MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides AI assistants with access to Trello's functionality. This server enables AI models to interact with Trello boards, lists, and cards programmatically.120 npm1ISC
- AlicenseBqualityDmaintenanceA Model Context Protocol server for Trello that connects AI agents to Trello boards with per-project configuration and local credentials.24255 npm2MIT