Trello-Desktop

Trello-Desktop is an MCP server that exposes Trello functionality to any MCP-compatible client (such as Claude Desktop, Claude Code, Gemini CLI, and others) over a secure local connection. It provides tools to search Trello content, manage boards, lists, and cards, add comments, and retrieve detailed information about cards, members, labels, and attachments. Once configured in your MCP client, you can issue natural-language commands to perform actions like searching for boards, creating or updating cards, moving cards between lists, or fetching detailed card histories. The server authenticates locally using Trello API credentials you provide via environment variables, so no credentials are sent over the network.

To use it, configure your MCP client to point to the Trello MCP server entry point (the Node.js script in dist/index.js) and supply your Trello API key and token as environment variables. After that, interact with the server through natural language prompts or the client’s command interface, and the server will translate your requests into Trello API calls through its 19 available tools across three phases (Essential, Core Operations, and Advanced Features).

Prerequisites:\n- Node.js 18+ installed\n- An MCP-compatible client (Claude Desktop, Claude Code, Gemini CLI, etc.)\n- Trello account with API credentials (API key and token)\n\nSetup steps:\n1. Clone the repository and open the project:\nbash\ngit clone https://github.com/kocakli/trello-desktop-mcp.git\ncd trello-desktop-mcp\n\n2. Install dependencies:\nbash\nnpm install\n\n3. Build the project:\nbash\nnpm run build\n\n4. Get Trello API credentials: visit https://trello.com/app-key, copy your API key, and generate a token with read/write access.\n5. Configure your MCP client (examples below):\n\nClaude Desktop:\njson\n{\n "mcpServers": {\n "trello": {\n "command": "node",\n "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],\n "env": {\n "TRELLO_API_KEY": "your-api-key-here",\n "TRELLO_TOKEN": "your-token-here"\n }\n }\n }\n}\n\nRestart Claude Desktop.\n\nClaude Code (CLI):\nbash\nclaude mcp add trello -- node /absolute/path/to/trello-desktop-mcp/dist/index.js \\n -e TRELLO_API_KEY=your-api-key-here \\n -e TRELLO_TOKEN=your-token-here\n\nOr add it to your project's .mcp.json:\njson\n{\n "mcpServers": {\n "trello": {\n "command": "node",\n "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],\n "env": {\n "TRELLO_API_KEY": "your-api-key-here",\n "TRELLO_TOKEN": "your-token-here"\n }\n }\n }\n}\n\nGemini CLI:\njson\n{\n "mcpServers": {\n "trello": {\n "command": "node",\n "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],\n "env": {\n "TRELLO_API_KEY": "your-api-key-here",\n "TRELLO_TOKEN": "your-token-here"\n }\n }\n }\n}\n\nOther MCP Clients: Run node /absolute/path/to/trello-desktop-mcp/dist/index.js and set environment variables TRELLO_API_KEY and TRELLO_TOKEN according to your client’s configuration format.\n6. Restart your MCP client to apply the new Trello server configuration.

Tips & caveats:\n- Keep Trello API credentials secure; they are stored only in your MCP client configuration.\n- The server uses HTTPS for Trello API calls and respects Trello rate limits with retry logic.\n- The MCP server exposes 19 tools organized across three phases (Essential, Core Operations, Advanced Features) plus legacy compatibility tools.\n- If you encounter "No Trello tools available", ensure your client is correctly pointed at the Node entry script and that the environment variables are set.\n- For debugging, check the dist/index.js path after building and ensure your client restarts after config changes.\n- If upgrading Node or dependencies, re-run npm install and npm run build to regenerate dist/.