Provides tools for managing Trello boards, lists, cards, checklists, labels, members, custom fields, organizations, and webhooks, enabling natural language interaction with Trello through Claude.
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 Server 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.
A Model Context Protocol (MCP) server that connects Trello to Claude Code. Manage your boards, lists, cards, checklists, and more — all through natural language.
73 tools | Zero config startup | Auto-loads
.env| Docker ready | Remote HTTP support
Claude Code CLI installed and authenticated
A Trello account
Docker (only needed for remote/Docker mode)
Related MCP server: Atlassian Trello MCP Server
Best for personal use on your own machine. Claude Code launches the server automatically — no Docker needed.
git clone https://github.com/GabrielRamirez/trello-mcp.git
cd trello-mcp
npm installRun the interactive setup wizard:
npm run setupIt will:
Ask for your API key — get one at trello.com/power-ups/admin
Open your browser to authorize the app
You click Allow, copy the token, and paste it back
Save both values to a .env file automatically
The
.envfile is git-ignored. Your credentials stay local.
claude mcp add trello -- npx tsx src/index.tsOpen Claude Code and ask:
List my Trello boardsYou should see your boards listed. The 73 Trello tools are now available in every Claude Code conversation.
Best for running on a server, sharing with a team, or keeping the server always-on. The server exposes an HTTP endpoint that Claude Code connects to via URL.
git clone https://github.com/GabrielRamirez/trello-mcp.git
cd trello-mcpcp .env.example .envOpen .env in your editor and fill in your values:
TRELLO_API_KEY=your-api-key-here
TRELLO_TOKEN=your-token-hereNeed credentials? Get your API key at trello.com/power-ups/admin, then click the token link on that page to authorize.
docker compose up --buildYou should see:
trello-mcp-1 | Trello MCP server listening on http://0.0.0.0:3333/mcpThe server will refuse to start if credentials are missing, with a clear error telling you what's needed.
In a new terminal:
curl http://localhost:3333/healthExpected response:
{"status":"ok"}claude mcp add --transport http trello http://localhost:3333/mcpIf the server is running on a remote machine, replace localhost with the server's hostname or IP:
claude mcp add --transport http trello http://your-server:3333/mcpOpen Claude Code and ask:
List my Trello boardsThe image is published on Docker Hub. No cloning or Node.js required.
docker run -d -p 3333:3333 \
-e TRELLO_API_KEY=your_key \
-e TRELLO_TOKEN=your_token \
--name trello-mcp \
gabermz/trello-mcpclaude mcp add --transport http trello http://localhost:3333/mcpThat's it — no Node.js, no cloning, no npm install.
Variable | Required | Default | Description |
| Yes | — | Your Trello API key (get one here) |
| Yes | — | Your Trello authorization token |
| No |
| HTTP server port (Docker/remote mode only) |
Register the server for everyone working in a specific project:
claude mcp add --transport http trello --scope project http://localhost:3333/mcpThis saves the config to .mcp.json in the project root, which you can commit to git.
.mcp.json with environment variable supportCreate .mcp.json in your project root:
{
"mcpServers": {
"trello": {
"type": "http",
"url": "${TRELLO_MCP_URL:-http://localhost:3333}/mcp"
}
}
}Each teammate can set TRELLO_MCP_URL to point to their own server, or omit it to use the default localhost:3333.
Once connected, just ask Claude in natural language:
You say | What happens |
"List my Trello boards" | Fetches all your boards |
"Show me the cards in my Sprint board" | Gets all cards on that board |
"Create a card called Fix login bug in the To Do list" | Creates a new card |
"Move that card to In Progress" | Moves a card between lists |
"Add a checklist called QA Steps to that card" | Creates a checklist |
"Search for cards about authentication" | Searches across all boards |
"Add a comment: Blocked by API rate limit" | Comments on a card |
"Archive all done cards" | Archives completed cards |
Tool | Description |
| List all boards for the authenticated user |
| Get board details by ID |
| Get all lists on a board |
| Get all cards on a board |
| Get all labels on a board |
| Get all members of a board |
| Get the activity feed for a board |
| Get custom field definitions on a board |
| Create a new board |
| Update name, description, closed status, or background |
| Permanently delete a board (irreversible) |
| Create a new label on a board |
| Add a member to a board with a role |
| Remove a member from a board |
Tool | Description |
| Get card details with checklists, labels, and members |
| Create a new card on a list |
| Update card name, description, due date, or position |
| Move a card to a different list or board |
| Archive a card (reversible) |
| Unarchive (reopen) a closed card |
| Permanently delete a card (irreversible) |
| Add a comment to a card |
| Edit a comment on a card |
| Delete a comment from a card |
| Add a label to a card |
| Remove a label from a card |
| Assign a member to a card |
| Unassign a member from a card |
| Get the activity feed for a card |
| List all attachments on a card |
| Add a URL attachment to a card |
| Delete an attachment from a card |
| Get custom field values for a card |
| Set a custom field value on a card |
Tool | Description |
| Get a list and all its cards |
| Create a new list on a board |
| Rename or reposition a list |
| Archive a list |
| Unarchive (reopen) a closed list |
| Move all cards from one list to another |
| Archive all cards in a list |
| Move a list to a different board |
Tool | Description |
| Create a checklist on a card |
| Get a checklist by ID with all its items |
| Rename or reposition a checklist |
| Permanently delete a checklist |
| Add an item to a checklist |
| Toggle, rename, or reposition a checklist item |
| Delete an item from a checklist |
Tool | Description |
| Get a label by ID |
| Update a label's name or color |
| Permanently delete a label |
Tool | Description |
| Get member info by ID or username |
| Get all cards assigned to a member |
| Get all boards a member belongs to |
| Get all workspaces a member belongs to |
| Get notifications for the authenticated user |
| Mark all notifications as read |
| Search for members by name, username, or email |
Tool | Description |
| Create a custom field definition on a board |
| Get a custom field definition by ID |
| Delete a custom field definition |
| Get dropdown options for a list-type custom field |
Tool | Description |
| Get workspace details by ID or name |
| Get all members of a workspace |
| Get all boards in a workspace |
| Create a new workspace |
| Update workspace name, description, or website |
Tool | Description |
| Create a webhook for model change notifications |
| Get webhook details by ID |
| Update a webhook's URL, model, or active status |
| Delete a webhook |
Tool | Description |
| Search boards and cards with Trello search operators ( |
Tools that require Trello Premium or Enterprise (Custom Fields, some board features) will return a clear error message if your account doesn't have access.
trello-mcp/
├── src/
│ ├── index.ts # Stdio entry point (local mode)
│ ├── remote.ts # HTTP entry point (Docker/remote mode)
│ ├── server.ts # Shared server factory
│ ├── trello-client.ts # HTTP client with auth and error handling
│ ├── types.ts # TypeScript interfaces for Trello objects
│ ├── tools/
│ │ ├── boards.ts # Board tools (14)
│ │ ├── cards.ts # Card tools (20)
│ │ ├── lists.ts # List tools (8)
│ │ ├── checklists.ts # Checklist tools (7)
│ │ ├── labels.ts # Label tools (3)
│ │ ├── members.ts # Member tools (7)
│ │ ├── customfields.ts # Custom Field tools (4)
│ │ ├── organizations.ts # Organization tools (5)
│ │ ├── webhooks.ts # Webhook tools (4)
│ │ └── search.ts # Search tool (1)
│ └── utils/
│ ├── env.ts # .env file loader
│ └── response.ts # Response formatting helpers
├── Dockerfile
├── docker-compose.yml
├── .env.example
├── package.json
├── tsconfig.json
└── tsup.config.tsProblem | Solution |
"Missing required environment variables" | Copy |
"Trello API credentials are not configured" | Run |
401 Unauthorized | Your API key or token is invalid. Run |
Server starts but no tools appear | Make sure you used |
"Cannot find module" errors | Run |
Docker health check failing | Ensure port 3333 isn't already in use. Check logs with |
Can't connect to remote server | Check firewall rules allow port 3333. Verify with |
# Install dependencies
npm install
# Run in dev mode (stdio, auto-loads .env)
npm run dev
# Build for production
npm run build
# Run HTTP server locally without Docker
npm run start:remote
# Run production build (stdio)
npm run startAdd a URL attachment to a Trello card.
Inputs: url (required), cardId (required), name.
Add a member to a board with a specified role.
Inputs: boardId (required), memberId (required), type.
Add an item to an existing checklist.
Inputs: name (required), checklistId (required), pos, checked.
Add a comment to a Trello card.
Inputs: text (required), cardId (required).
Add an existing label to a card.
Inputs: cardId (required), labelId (required).
Assign a member to a card.
Inputs: cardId (required), memberId (required).
Archive all cards in a list.
Inputs: listId (required).
Archive (close) a Trello card.
Inputs: cardId (required).
Archive (close) a Trello list.
Inputs: listId (required).
Create a new Trello board.
Inputs: name (required), desc, defaultLists.
Create a new card on a Trello list.
Inputs: name (required), idList (required), due, pos, +3 more.
Create a new checklist on a Trello card.
Inputs: name (required), cardId (required).
Create a new custom field definition on a board. Requires Trello Premium or Enterprise.
Inputs: name (required), type (required), idModel (required), pos.
Create a new label on a Trello board.
Inputs: name (required), color (required), boardId (required).
Create a new list on a Trello board.
Inputs: name (required), idBoard (required), pos.
Create a new Trello organization (workspace).
Inputs: displayName (required), desc, name, website.
Create a webhook to receive notifications when a Trello model changes. The callback URL must be publicly accessible and respond to HEAD requests.
Inputs: idModel (required), callbackURL (required), active, description.
Delete an attachment from a Trello card.
Inputs: cardId (required), attachmentId (required).
Permanently delete a Trello board. WARNING: This is irreversible — all lists, cards, and data on the board will be lost.
Inputs: boardId (required).
Permanently delete a Trello card. This cannot be undone — use archive_card for reversible removal.
Inputs: cardId (required).
Permanently delete a checklist from a card.
Inputs: checklistId (required).
Delete an item from a checklist.
Inputs: checkItemId (required), checklistId (required).
Delete a comment from a card.
Inputs: cardId (required), actionId (required).
Delete a custom field definition and all its values from every card. Requires Trello Premium or Enterprise.
Inputs: customFieldId (required).
Permanently delete a label from the board.
Inputs: labelId (required).
Delete a webhook.
Inputs: webhookId (required).
Get detailed information about a specific Trello board by its ID.
Inputs: boardId (required).
Get the activity feed (actions) for a board.
Inputs: boardId (required), limit, filter.
Get all cards on a Trello board.
Inputs: boardId (required), filter.
Get all custom field definitions on a board. Requires Trello Premium or Enterprise.
Inputs: boardId (required).
Get all labels defined on a Trello board.
Inputs: boardId (required).
Get all lists on a Trello board.
Inputs: boardId (required), filter.
Get all members of a Trello board.
Inputs: boardId (required).
Get detailed information about a specific Trello card, including its checklists, labels, and members.
Inputs: cardId (required).
Get the activity feed (actions) for a card.
Inputs: cardId (required), limit, filter.
Get custom field values for a Trello card. Requires Trello Premium or Enterprise.
Inputs: cardId (required).
Get a checklist by ID, including all its items.
Inputs: checklistId (required).
Get a custom field definition by ID. Requires Trello Premium or Enterprise.
Inputs: customFieldId (required).
Get the dropdown options for a list-type custom field. Requires Trello Premium or Enterprise.
Inputs: customFieldId (required).
Get a label by its ID.
Inputs: labelId (required).
Get a Trello list and its cards by list ID.
Inputs: listId (required).
Get information about a Trello member by ID or username. Use 'me' for the authenticated user.
Inputs: memberId (required).
Get all boards a member belongs to. Use 'me' for the authenticated user.
Inputs: memberId (required), filter.
Get all cards assigned to a member. Use 'me' for the authenticated user.
Inputs: memberId (required), filter.
Get all organizations (workspaces) a member belongs to. Use 'me' for the authenticated user.
Inputs: memberId (required).
Get notifications for the authenticated user.
Inputs: limit, readFilter.
Get details about a Trello organization (workspace) by ID or name.
Inputs: orgId (required).
Get all boards in a Trello organization (workspace).
Inputs: orgId (required), filter.
Get all members of a Trello organization (workspace).
Inputs: orgId (required).
Get details of a webhook by ID.
Inputs: webhookId (required).
List all attachments on a Trello card.
Inputs: cardId (required).
List all Trello boards for the authenticated user. Returns board id, name, description, URL, and closed status.
Inputs: filter.
Mark all notifications as read for the authenticated user.
Inputs: no named parameters.
Move all cards from one list to another.
Inputs: idList (required), listId (required), idBoard (required).
Move a card to a different list, and optionally to a different board.
Inputs: cardId (required), idList (required), pos, idBoard.
Move a list to a different board.
Inputs: listId (required), boardId (required).
Remove a member from a board.
Inputs: boardId (required), memberId (required).
Remove a label from a card.
Inputs: cardId (required), labelId (required).
Unassign a member from a card.
Inputs: cardId (required), memberId (required).
Search for boards and cards in Trello. Supports Trello search operators like @member, #label, list:name, is:open, is:archived, etc.
Inputs: query (required), partial, boardIds, cardsLimit, +2 more.
Search for Trello members by name, username, or email.
Inputs: query (required), limit, boardId, organizationId.
Unarchive (reopen) a closed Trello card.
Inputs: cardId (required).
Unarchive (reopen) a closed Trello list.
Inputs: listId (required).
Update a board's name, description, closed status, or background color.
Inputs: boardId (required), desc, name, closed, +1 more.
Update properties of an existing Trello card.
Inputs: cardId (required), due, pos, desc, +2 more.
Update a checklist's name or position.
Inputs: checklistId (required), pos, name.
Update a checklist item (toggle complete/incomplete, rename, or reposition).
Inputs: cardId (required), checkItemId (required), pos, name, +1 more.
Update the text of a comment on a card.
Inputs: text (required), cardId (required), actionId (required).
Set the value of a custom field on a card. Requires Trello Premium or Enterprise.
Inputs: cardId (required), customFieldId (required), value, idValue.
Update a label's name or color.
Inputs: labelId (required), name, color.
Update a list's name or position.
Inputs: listId (required), pos, name.
Update a Trello organization's (workspace) name, description, or website.
Inputs: orgId (required), desc, name, website, +1 more.
Update a webhook's callback URL, description, model, or active status.
Inputs: webhookId (required), active, idModel, callbackURL, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 73 tools
Most tools target a distinct resource and action, and descriptions clarify intent. Some overlap exists among board-listing tools (list_boards, get_member_boards, get_organization_boards) and card-listing tools (get_board_cards, get_list), but the scopes are explained well enough to avoid frequent misselection.
The dominant verb_noun pattern is consistent and readable, e.g., get_board_lists, create_card, update_list, delete_comment. Minor deviations like add_member_to_card vs remove_board_member, and list_attachments vs get_board_actions, introduce slight inconsistency but do not seriously undermine predictability.
With 73 tools, this is an extremely large surface area for an MCP server, exceeding the 50+ threshold for a severe mismatch. While Trello is a broad domain, this many tools creates navigation and selection overhead, and many operations could be consolidated or split into separate focused servers.
The tool set covers nearly the full lifecycle for boards, lists, cards, comments, checklists, labels, attachments, members, organizations, custom fields, webhooks, and notifications. Minor gaps exist, such as no organization deletion, no custom-field definition update, and no single notification read, but agents can work around these.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Trello in Claude Code in 60 seconds. No API key, no hosting. Hosted, OAuth sign-in, 18 tools.
AI-native Kanban board — connect Claude to claim, work and move your tasks over MCP.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
