This project provides a Model Context Protocol (MCP) server for interacting with Trello, designed to simplify Trello API integration for developers. It offers robust features like automatic rate limiting, type safety, and comprehensive error handling, significantly streamlining workflows for applications that need to manage Trello boards, cards, and activities. The recent migration to the Bun runtime delivers substantial performance improvements, making it a fast and efficient solution for Trello automation.

How It Works

Built with TypeScript and running on the Bun runtime, this MCP server acts as a middleware between clients and the Trello REST API. It abstracts the complexities of direct API calls, implementing crucial features such as rate limiting (adhering to Trello's 300 requests/10s per API key and 100 requests/10s per token limits) and input validation. This approach ensures type safety and graceful error handling, providing a more reliable and developer-friendly interface for Trello data manipulation.

Quick Start & Requirements

• Installation: Recommended installation is via the MCP Registry (mcp-server-trello or io.github.delorenj/mcp-server-trello). Alternatively, use bunx @delorenj/mcp-server-trello, npx/pnpx, or Docker.
• Prerequisites: Bun (v1.0.0 or higher) is recommended for optimal performance. A Trello API Key and a Trello Token are required for authentication.
• Setup: Obtain API credentials from Trello and configure them as environment variables (TRELLO_API_KEY, TRELLO_TOKEN). Docker installation involves cloning the repo, setting up .env, and running docker compose up --build.
• Links: CHANGELOG.md, Trello API Key generation: https://trello.com/app-key.

Highlighted Details

• Powered by Bun, offering a 2.8-4.4x performance boost over previous versions.
• Full Trello board integration, including comprehensive card data extraction (checklists, attachments, labels, members, comments).
• Supports file attachments from URLs and markdown formatting for card data export.
• Enables dynamic board and workspace selection without server restarts.
• Integrates with other MCP servers, such as Ideogram, for AI-powered content creation and attachment to Trello cards.

Maintenance & Community

The README does not specify details regarding maintainers, community channels (like Discord/Slack), or a public roadmap.

Licensing & Compatibility

This project is licensed under the MIT License, permitting commercial use and integration into closed-source projects.

Limitations & Caveats

The server's functionality is dependent on the Trello API's capabilities and the MCP protocol's defined tools. Specific limitations regarding unsupported Trello features or known bugs are not detailed in the provided README. Authentication requires generating and managing Trello API keys and tokens.