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_API_KEY": "<your-trello-api-key>",
"TRELLO_TOKEN": "<your-trello-token>",
"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
What this server can do
MCP Server Trello (delorenj) provides tools for these capabilities — tap one to see every MCP server that does the same:
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 →
AI-powered task-management system for AI-driven development that drops into Cursor, Windsurf, Claude Code, and more.
Gives AI assistants deep knowledge of 2,000+ n8n nodes, plus optional workflow management on your own n8n instance.
Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus.
Compare MCP Server Trello (delorenj) with: