$git clone https://github.com/delorenj/mcp-server-trelloA Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello's API while handling rate limiting, type safety, and error handling automatically.
| 1 | # MCP Server Trello |
| 2 | |
| 3 | [](https://mseep.ai/app/27359682-7632-4ba7-981d-7dfecadf1c4b) |
| 4 | [](https://registry.modelcontextprotocol.io/servers/io.github.delorenj/mcp-server-trello) |
| 5 | [](https://badge.fury.io/js/%40delorenj%2Fmcp-server-trello) |
| 6 | |
| 7 | <a href="https://glama.ai/mcp/servers/klqkamy7wt"><img width="380" height="200" src="https://glama.ai/mcp/servers/klqkamy7wt/badge" alt="Server Trello MCP server" /></a> |
| 8 | |
| 9 | A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello's API while handling rate limiting, type safety, and error handling automatically. |
| 10 | |
| 11 | ## 🎉 New in v1.5.0: Now Powered by Bun! ⚡ |
| 12 | |
| 13 | **This project is now powered by Bun!** 🚀 We've migrated the entire project to the Bun runtime, resulting in a 2.8-4.4x performance boost. All existing `npx`, `pnpx`, and `npm` commands will **continue to work perfectly**. |
| 14 | |
| 15 | ### ✨ New in This Release: |
| 16 | |
| 17 | - 🚀 **Performance Boost**: Enjoy a faster, more responsive server. |
| 18 | - **Bun-Powered**: The project now runs on the lightning-fast Bun runtime. |
| 19 | - 📖 **Comprehensive Examples**: A new `examples` directory with detailed implementations in JavaScript, Python, and TypeScript. |
| 20 | |
| 21 | **Plus:** Modern MCP SDK architecture, enhanced type safety, and comprehensive documentation! |
| 22 | |
| 23 | ## Changelog |
| 24 | |
| 25 | For a detailed list of changes, please refer to the [CHANGELOG.md](CHANGELOG.md) file. |
| 26 | |
| 27 | ## Features |
| 28 | |
| 29 | - **Full Trello Board Integration**: Interact with cards, lists, and board activities |
| 30 | - **🆕 Complete Card Data Extraction**: Fetch all card details including checklists, attachments, labels, members, and comments |
| 31 | - **💬 Comment Management**: Add, update, delete, and retrieve comments on cards |
| 32 | - **File Attachments**: Attach any type of file to cards (PDFs, documents, videos, images, etc.) from URLs |
| 33 | - **Built-in Rate Limiting**: Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token) |
| 34 | - **Type-Safe Implementation**: Written in TypeScript with comprehensive type definitions |
| 35 | - **Input Validation**: Robust validation for all API inputs |
| 36 | - **Error Handling**: Graceful error handling with informative messages |
| 37 | - **Dynamic Board Selection**: Switch between boards and workspaces without restarting |
| 38 | - **Markdown Formatting**: Export card data in human-readable markdown format |
| 39 | |
| 40 | ## Installation |
| 41 | |
| 42 | This repository is distributed as a **BMAD-compatible skill package** for the |
| 43 | Trello MCP server. Install the `skill/` directory through your agent's skill |
| 44 | management workflow, or place it in the agent's skills directory. |
| 45 | |
| 46 | When an agent activates the skill, it follows `skill/SKILL.md`. On first use, |
| 47 | the agent runs the bundled installer: |
| 48 | |
| 49 | ```bash |
| 50 | bash skill/scripts/install.sh |
| 51 | ``` |
| 52 | |
| 53 | The installer builds the MCP server from `skill/assets/source/` when Bun is |
| 54 | available. If Bun is unavailable, it falls back to the published Smithery |
| 55 | install path for `@delorenj/mcp-server-trello` and creates the same local |
| 56 | `build/index.js` command path used by the skill activation check. |
| 57 | |
| 58 | ## Skill package structure |
| 59 | |
| 60 | The skill is the agent-facing entry point for this repository. |
| 61 | |
| 62 | - `skill/SKILL.md`: Activation, routing, and agent workflow rules. |
| 63 | - `skill/scripts/install.sh`: First-run installer for the bundled server. |
| 64 | - `skill/references/trello-mcp/`: Focused references for setup, tools, |
| 65 | workflows, and gotchas. |
| 66 | - `skill/assets/source/`: Bundled MCP server source used for local builds. |
| 67 | |
| 68 | For AI agents, start with `skill/SKILL.md` rather than this README. The README |
| 69 | is the human-facing overview; the skill references are the operational surface |
| 70 | for tool selection and Trello workflow rules. |
| 71 | |
| 72 | Maintainers can refresh the bundled source before packaging with: |
| 73 | |
| 74 | ```bash |
| 75 | mise run package |
| 76 | ``` |
| 77 | |
| 78 | ## Configuration |
| 79 | |
| 80 | ### Environment Variables |
| 81 | |
| 82 | The server can be |