MCP Server Trello (delorenj)
Interact with Trello boards — cards, lists, comments — with built-in rate limiting and type safety.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @delorenj/mcp-server-trelloPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-server-trello-delorenj": {
"command": "npx",
"args": [
"-y",
"@delorenj/mcp-server-trello"
],
"env": {
"TRELLO_TOKEN": "<your-trello-token>",
"TRELLO_API_KEY": "<your-trello-api-key>",
"TRELLO_BOARD_ID": "<optional-default-board-id>"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js 16+ (Bun v1.0.0+ recommended; runs fine via npx/pnpx/bunx)
- A Trello API key from https://trello.com/app-key, set as TRELLO_API_KEY
- A Trello API token generated from that key, set as TRELLO_TOKEN
- Optional: TRELLO_WORKSPACE_ID, TRELLO_ALLOWED_WORKSPACES (comma-separated allowlist), and https_proxy for restricted networks
About MCP Server Trello (delorenj)
MCP Server Trello (by delorenj) is a stdio MCP server that lets AI assistants work with Trello boards — listing and creating cards, moving them between lists, managing checklists, comments, attachments, and custom fields. It wraps Trello's official REST API and adds type safety and automatic error handling.
A core feature is built-in rate limiting via a token-bucket algorithm that respects Trello's limits (300 requests / 10s per API key and 100 requests / 10s per token); requests are queued automatically when limits are hit, so agents don't get throttled errors.
It supports dynamic, multi-board and multi-workspace operation: you can switch the active board or workspace at runtime with set_active_board / set_active_workspace (preferences persist to ~/.trello-mcp/config.json) without restarting, and most calls accept an optional boardId to target a specific board. Workspace access can be restricted via an allowlist env var, and it supports HTTPS proxies for corporate networks.
Tools & capabilities (15)
list_boardsList the boards you have access to
set_active_boardSwitch the active board at runtime (persists to config)
get_active_board_infoGet info about the currently active board
get_listsList the lists on the active board
add_list_to_boardCreate a new list on the board
get_cards_by_list_idGet all cards in a given list
add_card_to_listCreate a new card in a list
update_card_detailsEdit a card's name, description, due date, labels, etc.
move_cardMove a card to a different list or board
archive_cardArchive (close) a card
get_my_cardsList cards assigned to the authenticated user
add_commentAdd a comment to a card
attach_file_to_cardAttach a file or image from a URL or local path
add_checklist_itemAdd an item to a card's checklist
get_recent_activityFetch recent activity on the board
When to use it
- Use it when you want an assistant to triage or update Trello cards from a chat instead of the web UI
- Use it when you need to bulk-create cards, lists, or checklist items from notes or a spec
- Use it when an agent must move cards through a workflow (e.g. To Do → Doing → Done) automatically
- Use it when you work across several boards or workspaces and want to switch context without restarting
- Use it when you need attachments, comments, or custom fields synced onto cards programmatically
- Use it when high-volume automation risks hitting Trello's rate limits and you want queueing handled for you
Quick setup
- 1Get your Trello API key at https://trello.com/app-key and generate a token from it
- 2Add the server to your MCP client config with command `bunx` (or `npx`/`pnpx`) and args `@delorenj/mcp-server-trello`
- 3Set the TRELLO_API_KEY and TRELLO_TOKEN env vars (plus optional workspace vars)
- 4Restart your MCP client so it picks up the new server
- 5Call list_boards then set_active_board to choose a board
- 6Verify with get_lists or get_active_board_info
Security notes
Requires a Trello API key and user token that grant access to your boards; store both in env vars and use TRELLO_ALLOWED_WORKSPACES to restrict scope. Tokens are long-lived, so revoke them from Trello if exposed.
MCP Server Trello (delorenj) FAQ
Where do I get the API key and token?
Create the API key at https://trello.com/app-key, then use it to generate a user token (also linked from that page). Set them as TRELLO_API_KEY and TRELLO_TOKEN.
Can I use more than one board?
Yes. Use set_active_board / set_active_workspace to switch context at runtime — preferences persist to ~/.trello-mcp/config.json — and most tools also accept an optional boardId. The older TRELLO_BOARD_ID env var is deprecated but still supported.
Will it hit Trello's rate limits?
It implements a token-bucket limiter matching Trello's quotas (300/10s per key, 100/10s per token) and automatically queues requests that would exceed them, so you avoid 429 errors.
Does it work behind a corporate proxy?
Yes, it honors the https_proxy environment variable for restricted networks.
Can it attach files and images to cards?
Yes, attach_file_to_card and attach_image_to_card accept both remote URLs and local file paths, including PDFs, images, and videos.
Alternatives to MCP Server Trello (delorenj)
Compare all alternatives →
Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.
Official Notion server to read, search, create, and update pages and databases in your workspace.
Read, search, and edit your Obsidian vault through the Local REST API community plugin.
Compare MCP Server Trello (delorenj) with: