{"_id":"@billnobill/trello-mcp-server","name":"@billnobill/trello-mcp-server","dist-tags":{"latest":"1.1.0"},"versions":{"1.1.0":{"name":"@billnobill/trello-mcp-server","version":"1.1.0","description":"Trello Model Context Protocol (MCP) Server for AI Agents","mcpName":"io.github.BillNobill/trello-mcp-server","type":"module","main":"dist/index.js","bin":{"trello-mcp-server":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/BillNobill/trello-mcp-server.git"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx ./src/index.ts","docker:build":"docker build -t trello-mcp-server .","docker:run":"docker run --rm -i --env-file .env trello-mcp-server"},"keywords":["mcp","trello","ai","automation","server"],"author":{"name":"Luiz Henrique Zavatini Feltrin"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","axios":"^1.6.0","cors":"^2.8.5","dotenv":"^16.5.0","express":"^4.18.0","form-data":"^4.0.5"},"devDependencies":{"@types/cors":"^2.8.17","@types/express":"^4.17.21","@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"gitHead":"d10685341933643e0a3aeaa797c1418ed1d7c18d","_id":"@billnobill/trello-mcp-server@1.1.0","bugs":{"url":"https://github.com/BillNobill/trello-mcp-server/issues"},"homepage":"https://github.com/BillNobill/trello-mcp-server#readme","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-g+MzHspYpj0c+wkeRSFFPTcLs8/9BbiGhH2uu7FuhoVZh96ngtEEEA6e/BcP02QhqTUsEzqa65m3mACPhHT+FA==","shasum":"fc7e6af63d431223d7d96dcc0812619e16d836ee","tarball":"https://registry.npmjs.org/@billnobill/trello-mcp-server/-/trello-mcp-server-1.1.0.tgz","fileCount":9,"unpackedSize":60665,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFIDYeUo89LElCkT6KB8hJZmeRU1/JKvBzZjU2+sBqaEAiAN71eqcX/7UMRzA8fLLBJEYP7dBowtolV0pIpmMAnUvg=="}]},"_npmUser":{"name":"billnobill","email":"luiz.zavatini19@gmail.com"},"directories":{},"maintainers":[{"name":"billnobill","email":"luiz.zavatini19@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/trello-mcp-server_1.1.0_1783750647715_0.32014557631029406"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T06:17:27.577Z","1.1.0":"2026-07-11T06:17:27.881Z","modified":"2026-07-11T06:17:28.041Z"},"maintainers":[{"name":"billnobill","email":"luiz.zavatini19@gmail.com"}],"description":"Trello Model Context Protocol (MCP) Server for AI Agents","homepage":"https://github.com/BillNobill/trello-mcp-server#readme","keywords":["mcp","trello","ai","automation","server"],"repository":{"type":"git","url":"git+https://github.com/BillNobill/trello-mcp-server.git"},"author":{"name":"Luiz Henrique Zavatini Feltrin"},"bugs":{"url":"https://github.com/BillNobill/trello-mcp-server/issues"},"license":"MIT","readme":"# 🚀 Trello MCP Server: AI-Powered Project Management\r\n\r\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.\r\n\r\n---\r\n\r\n## 🔍 Overview\r\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.\"*\r\n\r\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.\r\n\r\n---\r\n\r\n## 📋 Prerequisites\r\n- **Node.js** (v20.0.0 or higher recommended) - [Download here](https://nodejs.org/)\r\n- **Git** - [Download here](https://git-scm.com/)\r\n- **Trello API Key and Token**: [Get them here](https://trello.com/app-key)\r\n\r\n---\r\n\r\n## 🛠️ Quick Start\r\n\r\n### 1. Installation & Build\r\n```powershell\r\n# Clone the repository\r\ngit clone https://github.com/BillNobill/trello-mcp-server.git\r\n\r\n# Install dependencies and build\r\nnpm install\r\nnpm run build\r\n```\r\n\r\n### 2. Configuration\r\nCreate a `.env` file in the project root (use `.env.example` as a template):\r\n```env\r\nTRELLO_API_KEY=your_api_key\r\nTRELLO_TOKEN=your_token\r\nTRELLO_BASE_URL=https://api.trello.com/1\r\n```\r\n\r\n### 3. Register with Gemini CLI (Global)\r\nTo use this server anywhere on your computer, register it with the user scope:\r\n```powershell\r\ngemini mcp add trello node \"C:\\FULL_PATH\\TO\\trello-mcp-server\\dist\\index.js\" --scope user --trust\r\n```\r\n\r\n> [!IMPORTANT]\r\n> Always use the **absolute path** to `dist/index.js` in the command above.\r\n\r\n---\r\n\r\n## ⚡ Available Tools\r\n\r\nYour AI agent will automatically \"learn\" these advanced capabilities:\r\n\r\n### 📋 Board & List Management\r\n- `list_boards`: List all your Trello boards.\r\n- `read_board`: Deep dive into lists, cards, labels, and members.\r\n- `get_lists_on_board`: Fetch only column names and IDs.\r\n- `create_list` / `update_list`: Manage board columns and their ordering (`pos`).\r\n- `archive_list`: Cleanup board structure.\r\n- `get_board_labels` / `get_board_members`: Fetch IDs for precise automation.\r\n- `create_label` / `update_label`: Manage board labels (names and colors).\r\n\r\n### 🗂️ Card Operations (Granular & Optimized)\r\n- `get_cards_in_list`: Fetch cards for a specific column.\r\n- `get_card_details`: Deep dive into comments, attachments, and checklists for a **single** card.\r\n- `search_cards`: Perform fast text-based searches across the entire board.\r\n- `create_card` / `update_card`: Create or modify tasks (name, desc, dates, labels, and `pos`).\r\n- `move_card`: Change task status across lists (supports `pos`).\r\n- `move_all_cards`: **Bulk Action** to move all cards from one list to another.\r\n- `archive_card`: Cleanup completed work.\r\n\r\n### ✅ Checklist Management (Granular & Fluid)\r\n- `add_checklist`: Create a new checklist header on a card.\r\n- `update_checklist`: Rename or reorder an existing checklist header.\r\n- `delete_checklist`: Remove a checklist entirely.\r\n- `create_checkitem`: Add a new item to an existing checklist.\r\n- `update_checkitem`: **Update items** (rename, mark as complete/incomplete, or reorder).\r\n- `delete_checkitem`: Remove a specific item from a checklist.\r\n\r\n### 📁 Files & Attachments\r\n- `add_attachment`: Attach URL-based links to cards.\r\n- `upload_file`: **Upload real files** (PDFs, scripts, reports) directly from your computer to a card.\r\n\r\n### 🛠️ Professional Features\r\n- `set_custom_field`: Set values for Custom Fields (e.g., \"Estimate\", \"Project ID\"). *Note: Requires Custom Fields Power-Up enabled on the board.*\r\n- `assign_member`: Assign teammates to tasks.\r\n- `add_comment`: Discuss tasks directly through the AI.\r\n\r\n> [!TIP]\r\n> **Reordering (the `pos` parameter):**  \r\n> Use `'top'`, `'bottom'`, or a positive number (e.g., `1`) to precisely reorder cards, lists, checklists, and items.\r\n\r\n---\r\n\r\n## 🛠️ Troubleshooting\r\n\r\n> [!WARNING]\r\n> **Server shows as \"Disconnected\"?**\r\n> 1. **Empty Command:** If `/mcp list` shows a red dot, ensure your `settings.json` (at `C:\\Users\\YourUser\\.gemini\\settings.json`) has `\"command\": \"node\"` correctly set.\r\n> 2. **Environment Variables:** Run `node dist/index.js` manually. If it fails, your `.env` is likely missing from the root folder.\r\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 latest version.\r\n\r\n---\r\n\r\n## 🐳 Docker Support\r\n\r\n> [!TIP]\r\n> Docker is perfect for keeping your local environment clean.\r\n\r\n```powershell\r\n# Build\r\ndocker build -t trello-mcp-server .\r\n\r\n# Run\r\ndocker run --rm -i --env-file .env trello-mcp-server\r\n```\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\nContributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.\r\n\r\n---\r\n\r\n**Created by [Luiz Feltrin]**  \r\n*Show some love! Give this repository a ⭐️ if it helped you!*\r\n","readmeFilename":"README.md","_rev":"1-446a039d00e7b5df3b28051134310003"}