{
  "markdown": "# 🚀 Trello MCP Server: AI-Powered Project Management\n\nTransform your Trello boards into a living workspace for AI agents. This **Model Context Protocol (MCP)** server allows LLMs (like Gemini, Claude, and GPT-4) to see, organize, and manage your projects with natural language.\n\n---\n\n## 🔍 Overview\nThis project bridges the gap between AI and your Trello workflow. Instead of manually moving cards, you can tell your AI: *\"Move all 'To Do' cards with the 'Urgent' label to 'In Progress' and assign them to me.\"*\n\n**Global Usage:** You can save this project anywhere on your computer. Once registered, your AI will be able to start the server automatically whenever needed—no manual terminal execution required.\n\n---\n\n## 📋 Prerequisites\n- **Node.js** (v20.0.0 or higher recommended) - [Download here](https://nodejs.org/)\n- **Git** - [Download here](https://git-scm.com/)\n- **Trello API Key and Token**: [Get them here](https://trello.com/app-key)\n\n---\n\n## 🛠️ Quick Start\n\n### 1. Installation & Build\n```powershell\n# Clone the repository\ngit clone https://github.com/BillNobill/trello-mcp-server.git\n\n# Install dependencies and build\nnpm install\nnpm run build\n```\n\n### 2. Configuration\nCreate a `.env` file in the project root (use `.env.example` as a template):\n```env\nTRELLO_API_KEY=your_api_key\nTRELLO_TOKEN=your_token\nTRELLO_BASE_URL=https://api.trello.com/1\n```\n\n### 3. Register with your AI client\n\n#### Claude Code (Recommended)\n```powershell\nclaude mcp add --scope user trello node \"C:\\FULL_PATH\\TO\\trello-mcp-server\\dist\\index.js\"\n```\nEnv vars are read from the `.env` file or can be passed inline with `-e KEY=VALUE` flags.\n\n#### VS Code (GitHub Copilot / Claude extension)\nAdd to your user `settings.json` (`Ctrl+Shift+P` → *Open User Settings JSON*):\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"trello\": {\n        \"command\": \"node\",\n        \"args\": [\"C:\\\\FULL_PATH\\\\TO\\\\trello-mcp-server\\\\dist\\\\index.js\"],\n        \"env\": {\n          \"TRELLO_API_KEY\": \"your_api_key\",\n          \"TRELLO_TOKEN\": \"your_token\",\n          \"TRELLO_BASE_URL\": \"https://api.trello.com/1\"\n        }\n      }\n    }\n  }\n}\n```\n\n#### Cursor\nAdd to `%USERPROFILE%\\.cursor\\mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"trello\": {\n      \"command\": \"node\",\n      \"args\": [\"C:\\\\FULL_PATH\\\\TO\\\\trello-mcp-server\\\\dist\\\\index.js\"],\n      \"env\": {\n        \"TRELLO_API_KEY\": \"your_api_key\",\n        \"TRELLO_TOKEN\": \"your_token\",\n        \"TRELLO_BASE_URL\": \"https://api.trello.com/1\"\n      }\n    }\n  }\n}\n```\n\n> [!IMPORTANT]\n> Always use the **absolute path** to `dist/index.js` in the configuration above.\n\n---\n\n## ⚡ Available Tools\n\nYour AI agent will automatically \"learn\" these advanced capabilities:\n\n### 📋 Board & List Management\n- `list_boards`: List all your Trello boards.\n- `read_board`: Deep dive into lists, cards, labels, and members.\n- `get_lists_on_board`: Fetch only column names and IDs.\n- `create_list` / `update_list`: Manage board columns and their ordering (`pos`).\n- `archive_list`: Cleanup board structure.\n- `get_board_labels` / `get_board_members`: Fetch IDs for precise automation.\n- `create_label` / `update_label`: Manage board labels (names and colors).\n\n### 🗂️ Card Operations (Granular & Optimized)\n- `get_cards_in_list`: Fetch cards for a specific column.\n- `get_card_details`: Deep dive into comments, attachments, and checklists for a **single** card.\n- `search_cards`: Perform fast text-based searches across the entire board.\n- `create_card` / `update_card`: Create or modify tasks (name, desc, dates, labels, and `pos`).\n- `move_card`: Change task status across lists (supports `pos`).\n- `move_all_cards`: **Bulk Action** to move all cards from one list to another.\n- `archive_card`: Cleanup completed work.\n\n### ✅ Checklist Management (Granular & Fluid)\n- `add_checklist`: Create a new checklist header on a card.\n- `update_checklist`: Rename or reorder an existing checklist header.\n- `delete_checklist`: Remove a checklist entirely.\n- `create_checkitem`: Add a new item to an existing checklist.\n- `update_checkitem`: **Update items** (rename, mark as complete/incomplete, or reorder).\n- `delete_checkitem`: Remove a specific item from a checklist.\n\n### 📁 Files & Attachments\n- `add_attachment`: Attach URL-based links to cards.\n- `upload_file`: **Upload real files** (PDFs, scripts, reports) directly from your computer to a card.\n\n### 🛠️ Professional Features\n- `set_custom_field`: Set values for Custom Fields (e.g., \"Estimate\", \"Project ID\"). *Note: Requires Custom Fields Power-Up enabled on the board.*\n- `assign_member`: Assign teammates to tasks.\n- `add_comment`: Discuss tasks directly through the AI.\n\n> [!TIP]\n> **Reordering (the `pos` parameter):**  \n> Use `'top'`, `'bottom'`, or a positive number (e.g., `1`) to precisely reorder cards, lists, checklists, and items.\n\n---\n\n## 🛠️ Troubleshooting\n\n> [!WARNING]\n> **Server shows as \"Disconnected\"?**\n> 1. **Empty Command:** Check your client's MCP config and confirm `\"command\": \"node\"` and the absolute path to `dist/index.js` are correct.\n> 2. **Environment Variables:** Run `node dist/index.js` manually in the terminal. If it fails, your `.env` is likely missing from the root folder.\n> 3. **SDK Compatibility:** This project uses `@modelcontextprotocol/sdk` v1.29.0. If you experience protocol errors, run `npm install` to ensure you have the correct version.\n> 4. **Claude Code:** Run `/mcp` inside a Claude Code session to see the server status and any error output.\n\n---\n\n## 🐳 Docker Support\n\n> [!TIP]\n> Docker is perfect for keeping your local environment clean.\n\n```powershell\n# Build\ndocker build -t trello-mcp-server .\n\n# Run\ndocker run --rm -i --env-file .env trello-mcp-server\n```\n\n---\n\n## 🤝 Contributing\nContributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.\n\n---\n\n**Created by [Luiz Feltrin]**  \n*Show some love! Give this repository a ⭐️ if it helped you!*\n",
  "bytes": 5918,
  "sha": "2152d85b49690ca5718230b25da729134f12161039bae2cb50facde60554e173",
  "repo_slug": "billnobill/trello-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_billnobill_trello_mcp_server_ac040deb/readme"
}