MCP Server Trello

What is MCP Server Trello?

MCP Server Trello is a Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. It handles rate limiting, type safety, and error handling automatically, and integrates with Trello’s API to manage cards, lists, checklists, comments, attachments, and board activities. It is built with Bun for performance and is distributed as a BMAD‑compatible skill package, also installable via npm/pnpx/npx.

How to use MCP Server Trello?

Install by activating the bundled skill (skill/SKILL.md) or by using the Smithery install path for @delorenj/mcp-server-trello. Configure required environment variables TRELLO_API_KEY and TRELLO_TOKEN. Optionally set a default board (TRELLO_BOARD_ID) or workspace (TRELLO_WORKSPACE_ID). Invoke MCP tools such as list_boards, set_active_board, get_card, or the checklist tools (e.g., get_checklist_items).

Key features of MCP Server Trello

• Full Trello board integration with cards, lists, and activities
• Complete card data extraction including checklists, attachments, labels, members, and comments
• Comment management (add, update, delete, retrieve)
• File attachment support from URLs (PDFs, images, documents, etc.)
• Built‑in rate limiting respecting Trello’s 300 req/10s (key) and 100 req/10s (token) limits
• Dynamic board and workspace selection without restart
• Markdown formatting for card data exports
• Workspace access restriction via environment variable

Use cases of MCP Server Trello

• Automate project management tasks by letting an AI agent create, update, and retrieve Trello cards.
• Generate summary reports from board data using the markdown export feature.
• Manage checklists and acceptance criteria programmatically across multiple boards.
• Integrate Trello with other MCP tools for end‑to‑end workflow automation.
• Limit AI agent access to approved Trello workspaces in multi‑tenant setups.

FAQ from MCP Server Trello

What authentication is required?

You must obtain a Trello API key (from trello.com/app-key) and a Token generated from that key. Provide them as environment variables TRELLO_API_KEY and TRELLO_TOKEN.

Does the server have any rate limits?

Yes. The built‑in rate limiter respects Trello’s limits: 300 requests per 10 seconds per API key and 100 requests per 10 seconds per token.

Where does the server store persistent state?

The active board and workspace selections are stored in ~/.trello-mcp/config.json on the machine where the server runs, persisting across restarts.

What transport protocol does it use?

As an MCP server, it communicates using the Model Context Protocol (SDK) – typically over stdio or HTTP depending on the host environment. The README does not specify a custom transport.

Can I restrict which workspaces the server can access?

Yes. Set the TRELLO_ALLOWED_WORKSPACES environment variable to a comma‑separated list of workspace IDs. The server will then only list, access, or create boards within those workspaces.