{"_id":"@asapo/trello-mcp-server","_rev":"5-9af00c8d7c68265c0d4bf05ba63ed057","name":"@asapo/trello-mcp-server","dist-tags":{"latest":"1.3.1"},"versions":{"1.0.0":{"name":"@asapo/trello-mcp-server","version":"1.0.0","keywords":["mcp","trello","api","cards","comments"],"author":{"name":"Johannes"},"license":"MIT","_id":"@asapo/trello-mcp-server@1.0.0","maintainers":[{"name":"asapo","email":"wachter.johannes@hotmail.com"}],"homepage":"https://github.com/wachterjohannes/trello-mcp#readme","bugs":{"url":"https://github.com/wachterjohannes/trello-mcp/issues"},"bin":{"trello-mcp-server":"build/index.js"},"dist":{"shasum":"872bdc98d182a53d1574936b17435b121836dccb","tarball":"https://registry.npmjs.org/@asapo/trello-mcp-server/-/trello-mcp-server-1.0.0.tgz","fileCount":12,"integrity":"sha512-BDOMs/DWcTTa+5CyG/AHkIN6Yzr1Z7ogSl+64OalPakI/2E6mjvjeLq66gyIQJzF7XIyL3OJ7aFLzSSgAbD41w==","signatures":[{"sig":"MEUCIQCFSkdC7y7divkJwaRAdloWTBiutrdbuh9hT+tQnLKffgIgMwoRSIlee35ZzjNrN8A/0+3arwH3U9BPPOF1L0WZOqs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":175697},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18"},"gitHead":"2976e47e760db609f189ea0baef562409d991353","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"asapo","email":"wachter.johannes@hotmail.com"},"repository":{"url":"git+ssh://git@github.com/wachterjohannes/trello-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Trello API integration - manage cards, lists, and labels on Trello boards","directories":{},"_nodeVersion":"22.15.0","dependencies":{"axios":"^1.6.0","dotenv":"^16.3.0","@modelcontextprotocol/sdk":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/trello-mcp-server_1.0.0_1783510091916_0.4071812470941676","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@asapo/trello-mcp-server","version":"1.1.0","keywords":["mcp","trello","api","cards","comments"],"author":{"name":"Johannes"},"license":"MIT","_id":"@asapo/trello-mcp-server@1.1.0","maintainers":[{"name":"asapo","email":"wachter.johannes@hotmail.com"}],"homepage":"https://github.com/wachterjohannes/trello-mcp#readme","bugs":{"url":"https://github.com/wachterjohannes/trello-mcp/issues"},"bin":{"trello-mcp-server":"build/index.js"},"dist":{"shasum":"67d24931ec632dbfb7e5b5cf33412935acb2526c","tarball":"https://registry.npmjs.org/@asapo/trello-mcp-server/-/trello-mcp-server-1.1.0.tgz","fileCount":12,"integrity":"sha512-3oztj9yR72JgX9QM9OLTTaNAHOCzAvQeTD2F77aOAfnaLo9DOcLc7U8ahVrc5RVOOOkVJy/CN67cHec+SlPWKA==","signatures":[{"sig":"MEYCIQCd+3hlzedO8tOWew5z04rT0pfHp36p2y8lQlTcvWrirwIhAJcQxgjQrOzRTX5MrFlTowFF4Y0QlSDGH9zO08tIOwix","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":184051},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18"},"gitHead":"51b9fcff1669f218e533f83706b009e08c0a38cc","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"asapo","email":"wachter.johannes@hotmail.com"},"repository":{"url":"git+ssh://git@github.com/wachterjohannes/trello-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Trello API integration - manage cards, lists, and labels on Trello boards","directories":{},"_nodeVersion":"22.15.0","dependencies":{"axios":"^1.6.0","dotenv":"^16.3.0","@modelcontextprotocol/sdk":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/trello-mcp-server_1.1.0_1784626856023_0.9413639303319146","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@asapo/trello-mcp-server","version":"1.2.0","keywords":["mcp","trello","api","cards","comments","cli"],"author":{"name":"Johannes"},"license":"MIT","_id":"@asapo/trello-mcp-server@1.2.0","maintainers":[{"name":"asapo","email":"wachter.johannes@hotmail.com"}],"homepage":"https://github.com/wachterjohannes/trello-mcp#readme","bugs":{"url":"https://github.com/wachterjohannes/trello-mcp/issues"},"bin":{"trello":"build/cli.js","trello-mcp-server":"build/index.js"},"dist":{"shasum":"aca0c58b3a71e407190d6330ca02a85e5fa59cf1","tarball":"https://registry.npmjs.org/@asapo/trello-mcp-server/-/trello-mcp-server-1.2.0.tgz","fileCount":50,"integrity":"sha512-IeVi9ZHCizY4PMxzknCdPI27w2gp5OfaP+nrYfDsRLfyWv0rcLJKWn00FuPJwMIAJDzUW4JcDhsr71Fu7p/eDQ==","signatures":[{"sig":"MEUCID2TDKNEIW8uJ6SqR1JEwaKoL79ST00MKb28LkQ6trpSAiEAk49DfoA9hwjC+UxGfLY2OjGFsM6kaNR9D5N0QCako7o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":300090},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18"},"gitHead":"23ccdf00f78e7125baeda37ebb07806bfdb1371d","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"npm run build && node --test \"tests/*.test.mjs\"","build":"tsc && chmod +x build/index.js build/cli.js","start":"node build/index.js","trello":"node build/cli.js","postinstall":"node scripts/postinstall.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"asapo","email":"wachter.johannes@hotmail.com"},"repository":{"url":"git+ssh://git@github.com/wachterjohannes/trello-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Trello API integration - manage cards, lists, and labels on Trello boards","directories":{},"_nodeVersion":"22.15.0","dependencies":{"axios":"^1.6.0","dotenv":"^16.3.0","@modelcontextprotocol/sdk":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/trello-mcp-server_1.2.0_1786022245625_0.6208049306898942","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@asapo/trello-mcp-server","version":"1.3.0","keywords":["mcp","trello","api","cards","comments","cli"],"author":{"name":"Johannes"},"license":"MIT","_id":"@asapo/trello-mcp-server@1.3.0","maintainers":[{"name":"asapo","email":"wachter.johannes@hotmail.com"}],"homepage":"https://github.com/wachterjohannes/trello-mcp#readme","bugs":{"url":"https://github.com/wachterjohannes/trello-mcp/issues"},"bin":{"trello":"build/cli.js","trello-mcp-server":"build/index.js"},"dist":{"shasum":"6e433710fb36f6fd8dae62072d2ceb0c343f1b4c","tarball":"https://registry.npmjs.org/@asapo/trello-mcp-server/-/trello-mcp-server-1.3.0.tgz","fileCount":50,"integrity":"sha512-bfNS1URpGA9VWIoBlq1+iYAhnBGm1+VQj35Ve3yOW0BYaw3rUQV3nxqN9745fkyGwXmdfRIe+u4vMc4I0FxavQ==","signatures":[{"sig":"MEUCIQCfyaqoXFIBu8DjeCy2ArVZh7wl7VTANnprdAQh5lWZVgIgbuY3xMO861zgg0HLU2LUs9uVliP53XH3ZTJd4sUIEY0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":316508},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18"},"gitHead":"8ca32b49c4ed74057028d689e46136d5b8811ce2","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"npm run build && node --test \"tests/*.test.mjs\"","build":"tsc && chmod +x build/index.js build/cli.js","start":"node build/index.js","trello":"node build/cli.js","postinstall":"node scripts/postinstall.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"asapo","email":"wachter.johannes@hotmail.com"},"repository":{"url":"git+ssh://git@github.com/wachterjohannes/trello-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Trello API integration - manage cards, lists, and labels on Trello boards","directories":{},"_nodeVersion":"22.15.0","dependencies":{"axios":"^1.6.0","dotenv":"^16.3.0","@modelcontextprotocol/sdk":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/trello-mcp-server_1.3.0_1787753509812_0.7057488866839638","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@asapo/trello-mcp-server","version":"1.3.1","description":"MCP server for Trello API integration - manage cards, lists, and labels on Trello boards","main":"build/index.js","bin":{"trello-mcp-server":"build/index.js","trello":"build/cli.js"},"type":"module","scripts":{"build":"tsc && chmod +x build/index.js build/cli.js","dev":"tsc --watch","start":"node build/index.js","trello":"node build/cli.js","lint":"eslint src/**/*.ts","test":"npm run build && node --test \"tests/*.test.mjs\"","postinstall":"node scripts/postinstall.mjs","prepublishOnly":"npm run build"},"keywords":["mcp","trello","api","cards","comments","cli"],"publishConfig":{"access":"public"},"author":{"name":"Johannes"},"license":"MIT","repository":{"type":"git","url":"git+ssh://git@github.com/wachterjohannes/trello-mcp.git"},"homepage":"https://github.com/wachterjohannes/trello-mcp#readme","bugs":{"url":"https://github.com/wachterjohannes/trello-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^0.6.0","axios":"^1.6.0","dotenv":"^16.3.0"},"devDependencies":{"@types/node":"^20.0.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","eslint":"^8.0.0","jest":"^29.0.0","typescript":"^5.0.0"},"engines":{"node":">=18"},"_id":"@asapo/trello-mcp-server@1.3.1","gitHead":"13c263d964a0af28f23550a8a2e2287748eb35f4","types":"./build/index.d.ts","_nodeVersion":"22.15.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-6KdXLlvxatS6QJ31XUlHIlDFjArWBhk0VOdO+MYZ2u0cKaoBW3XRUz9H0XeOayd5Y+WIswwLEdv6b+pLu0e1yg==","shasum":"83e62672db2e6e8bd0483ac462221e3bf04d00d1","tarball":"https://registry.npmjs.org/@asapo/trello-mcp-server/-/trello-mcp-server-1.3.1.tgz","fileCount":50,"unpackedSize":318037,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHUalXfmds0VkOpm3n8+aRwdG9zlQdogZVR/RELU6w3GAiAxo/LC2qhMF1BuX+bJ0FSX6cNuZMPfmffBgxmUV7Ec4g=="}]},"_npmUser":{"name":"asapo","email":"wachter.johannes@hotmail.com"},"directories":{},"maintainers":[{"name":"asapo","email":"wachter.johannes@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/trello-mcp-server_1.3.1_1788495892388_0.4494694462236646"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-08T11:28:11.770Z","modified":"2026-09-04T04:24:52.918Z","1.0.0":"2026-07-08T11:28:12.091Z","1.1.0":"2026-07-21T09:40:56.184Z","1.2.0":"2026-08-06T13:17:25.782Z","1.3.0":"2026-08-26T14:11:49.945Z","1.3.1":"2026-09-04T04:24:52.724Z"},"bugs":{"url":"https://github.com/wachterjohannes/trello-mcp/issues"},"author":{"name":"Johannes"},"license":"MIT","homepage":"https://github.com/wachterjohannes/trello-mcp#readme","keywords":["mcp","trello","api","cards","comments","cli"],"repository":{"type":"git","url":"git+ssh://git@github.com/wachterjohannes/trello-mcp.git"},"description":"MCP server for Trello API integration - manage cards, lists, and labels on Trello boards","maintainers":[{"name":"asapo","email":"wachter.johannes@hotmail.com"}],"readme":"# @asapo/trello-mcp-server\n\n[![npm version](https://badge.fury.io/js/@asapo%2Ftrello-mcp-server.svg)](https://badge.fury.io/js/@asapo%2Ftrello-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server that provides comprehensive tools for interacting with the Trello API to manage cards, lists, and labels on your Trello boards. Perfect for project management automation and team collaboration workflows.\n\n## Features\n\n- ✨ **Card Management**: Create, read, and search cards with full control over position, due dates, members, labels, and location data\n- 📑 **Template Cards**: Copy an existing (template) card so Trello carries description, labels, checklists and custom field values over for you\n- 📋 **List Management**: Create and retrieve lists from boards with position control\n- 🏷️ **Label Management**: Create and retrieve labels with color customization\n- ☑️ **Checklist Management**: Create checklists with seeded items, add/update/reorder items, mark complete/incomplete\n- 🔗 **Card Cross-Linking**: Attach URLs (or other Trello cards) so they appear as preview chips in the sidebar\n- 📎 **File Attachments**: Upload local files (images, PDFs, logs) directly to cards\n- 💬 **Comment Integration**: Add comments to cards for status updates and team communication\n- 🔍 **Advanced Search**: Search cards across boards or within specific projects with flexible query options\n- 📊 **Board Analysis**: Access board information and analyze project structures\n- 🖥️ **CLI & Scripting**: Run every tool from the terminal with `npx`, or chain calls in a JSON script\n- ⚡ **High Performance**: Optimized API calls with comprehensive field selection\n- 🔒 **Secure Authentication**: Environment-based API key and token management\n\n## Installation\n\nInstall the package globally to use with Claude Desktop or Claude Code:\n\n```bash\nnpm install -g @asapo/trello-mcp-server\n```\n\nOr install locally for development:\n\n```bash\nnpm install @asapo/trello-mcp-server\n```\n\n## Configuration\n\n### Get Trello API Credentials\n\n1. Get your API key from: https://trello.com/app-key\n2. Generate a token using your API key at: https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=MCP%20Server&key=YOUR_API_KEY\n\n### Environment Setup\n\nSet your Trello credentials as environment variables:\n\n```bash\nexport TRELLO_API_KEY=your_trello_api_key_here\nexport TRELLO_TOKEN=your_trello_token_here\n```\n\nOr create a `.env` file:\n\n```env\nTRELLO_API_KEY=your_trello_api_key_here\nTRELLO_TOKEN=your_trello_token_here\n```\n\n## Usage\n\n### Quick Setup with Claude MCP\n\n#### From npm Package\n\nThe easiest way to add this server to Claude Desktop or Claude Code:\n\n```bash\nclaude mcp add trello @asapo/trello-mcp-server \\\n  -e TRELLO_API_KEY=your_api_key_here \\\n  -e TRELLO_TOKEN=your_token_here\n```\n\nGet your Trello API credentials:\n- **TRELLO_API_KEY**: Get from https://trello.com/app-key\n- **TRELLO_TOKEN**: Generate at https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=MCP%20Server&key=YOUR_API_KEY\n\n#### From Local Clone\n\nIf you've cloned the repository for development:\n\n```bash\n# Clone and setup\ngit clone git@github.com:wachterjohannes/trello-mcp.git\ncd trello-mcp\nnpm install\nnpm run build\n\n# Add to Claude with environment variables\nclaude mcp add trello node $(pwd)/build/index.js \\\n  -e TRELLO_API_KEY=your_api_key_here \\\n  -e TRELLO_TOKEN=your_token_here\n```\n\nOr with absolute path:\n\n```bash\nclaude mcp add trello node /absolute/path/to/trello-mcp/build/index.js \\\n  -e TRELLO_API_KEY=your_api_key_here \\\n  -e TRELLO_TOKEN=your_token_here\n```\n\n### Manual Claude Desktop Integration\n\nAlternatively, manually add to your Claude Desktop configuration:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"trello\": {\n      \"command\": \"npx\",\n      \"args\": [\"@asapo/trello-mcp-server\"],\n      \"env\": {\n        \"TRELLO_API_KEY\": \"your_api_key_here\",\n        \"TRELLO_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Manual Claude Code Integration\n\nAlternatively, manually add to your `~/.claude/settings.json`:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"trello\": {\n        \"command\": \"npx\",\n        \"args\": [\"@asapo/trello-mcp-server\"],\n        \"env\": {\n          \"TRELLO_API_KEY\": \"your_api_key_here\",\n          \"TRELLO_TOKEN\": \"your_token_here\"\n        }\n      }\n    }\n  }\n}\n```\n\n## CLI Usage\n\nEvery tool is also available on the command line — no MCP client required. The\nCLI and the MCP server share one tool registry, so tool names and arguments are\nidentical in both.\n\n```bash\nnpm install -g @asapo/trello-mcp-server\ntrello setup                                     # authenticate + install the agent skill\ntrello get_board_lists 507f1f77bcf86cd799439011\n```\n\nWithout a global install, run any command through\n`npx -p @asapo/trello-mcp-server trello <...>`.\n\n### Setup and authentication\n\n`trello setup` walks through connecting a Trello account: it links to\nhttps://trello.com/app-key for the API key, builds the authorization URL for a\nread/write token, verifies both against the Trello API, and stores them in\n`~/.config/trello-cli/credentials.json` with `0600` permissions (token input is\nmasked while typing). It then installs the agent skill.\n\n```bash\ntrello setup                                  # interactive\ntrello setup --api-key <key> --token <token>  # non-interactive, e.g. in CI\ntrello setup --reauth                         # replace stored credentials\ntrello setup --no-agent-skills                # authenticate only\ntrello setup --no-auth                        # install/refresh the skill only\ntrello setup --dry-run                        # verify and report, write nothing\n```\n\nCredential lookup order: `TRELLO_API_KEY` / `TRELLO_TOKEN` in the environment\n(including a `.env` file in the working directory), then the stored credentials.\nThe MCP server uses the same order, so `trello setup` also covers it. Nothing is\nwritten if verification fails.\n\n### Agent skills\n\nThe package bundles a Claude Code skill, [`skills/trello-cli`](skills/trello-cli/SKILL.md),\nthat teaches an agent to drive this CLI — discovery, argument shapes, when to\nscript, and which operations to confirm first. It is installed into every agent\nroot directory that exists (`~/.claude`, `~/.agents`, plus `CLAUDE_CONFIG_DIR`\nwhen set):\n\n- automatically on a **global** install (`npm install -g`), and again on\n  `npm install -g <pkg>@latest` or `npm update -g <pkg>`, which is how the skill\n  is refreshed — npm has no separate update hook;\n- on demand with `trello setup` (or `trello setup --no-auth` for skills only).\n\nDirectories are never created implicitly, local (non-global) installs never\nwrite to your home directory, and `TRELLO_NO_AGENT_SKILLS=1` disables the\nautomatic install entirely. Use `--dir <path>` to install somewhere else.\n\n### Discovering tools\n\n```bash\ntrello list             # all 24 tools with a one-line description\ntrello help create_card # arguments, types and which ones are required\n```\n\n### Calling a tool\n\nRequired arguments can be passed positionally (in the order shown by\n`trello help <tool>`); everything else is a flag:\n\n```bash\ntrello add_card_comment abc123 \"Deployed to staging\"\n\ntrello create_card \\\n  --idList 507f191e810c19729de860ea \\\n  --name \"Implement new feature\" \\\n  --desc \"Add authentication system\" \\\n  --pos top \\\n  --due 2024-12-31T23:59:59.000Z \\\n  --idLabels labelId1,labelId2\n```\n\nFlags follow the tool's JSON schema:\n\n| Argument type | How to pass it |\n|---------------|----------------|\n| string | `--name \"Fix login\"` |\n| number | `--pos 3` |\n| boolean | `--dueComplete`, `--dueComplete=false`, or `--no-closed` |\n| ID lists | `--idLabels a,b` or repeated `--idLabels a --idLabels b` |\n| text lists | repeat the flag: `--items \"Step one\" --items \"Step two\"` |\n| nullable | `--due null` to clear a due date |\n\nFlag names also accept kebab-case (`--board-id` works as well as `--boardId`),\nand a whole argument object can be passed as JSON:\n\n```bash\ntrello update_card --json '{\"cardId\":\"abc123\",\"name\":\"Renamed\",\"pos\":\"top\"}'\n```\n\nResults are printed to stdout as JSON, so they pipe into `jq`:\n\n```bash\ntrello get_board_cards <boardId> --compact | jq '.[] | select(.due != null) | .name'\n```\n\nGlobal options: `--dry-run` (print the resolved call without executing it),\n`--compact` (single-line JSON), `--help`, `--version`.\n\n### Scripts\n\nMultiple calls can be chained in a JSON script and executed top to bottom, with\nlater steps referencing earlier results:\n\n```json\n{\n  \"name\": \"Sprint setup\",\n  \"steps\": [\n    {\n      \"id\": \"list\",\n      \"tool\": \"create_list\",\n      \"args\": { \"name\": \"Sprint 42\", \"idBoard\": \"{{env.TRELLO_BOARD_ID}}\", \"pos\": \"top\" }\n    },\n    {\n      \"id\": \"card\",\n      \"tool\": \"create_card\",\n      \"args\": { \"idList\": \"{{list.id}}\", \"name\": \"Sprint 42 kickoff\" }\n    },\n    {\n      \"tool\": \"create_checklist\",\n      \"args\": {\n        \"idCard\": \"{{card.id}}\",\n        \"name\": \"Preparation\",\n        \"items\": [\"Groom the backlog\", \"Confirm capacity\"]\n      }\n    }\n  ]\n}\n```\n\n```bash\ntrello run sprint-setup.json            # execute it\ntrello run sprint-setup.json --dry-run  # validate and preview, no API calls\ncat sprint-setup.json | trello run -    # read from stdin\n```\n\n- A step with an `\"id\"` is referenced by later steps as `{{id.path.to.value}}`\n  (`{{steps.id...}}` also works); environment variables are `{{env.NAME}}`.\n- A placeholder that fills a whole string keeps the original value's type;\n  embedded placeholders are interpolated as text.\n- Unknown tools, duplicate ids and forward references are rejected before the\n  first API call.\n- The run stops at the first failing step unless `--continue-on-error` is given;\n  progress goes to stderr (silence it with `--quiet`), and the array of step\n  results goes to stdout.\n\nA complete example lives in [`examples/sprint-setup.json`](examples/sprint-setup.json).\n\n## Available Tools\n\n### `create_card`\nCreate a new card in a Trello list with full parameter support.\n\n```typescript\n// Parameters\n{\n  \"idList\": \"string\",       // Required: Trello list ID\n  \"name\": \"string\",         // Required: Card title\n  \"desc\": \"string?\",        // Optional: Card description (supports Markdown)\n  \"pos\": \"number|'top'|'bottom'?\", // Optional: Position in list\n  \"due\": \"string?\",         // Optional: Due date (ISO 8601 format)\n  \"dueComplete\": \"boolean?\", // Optional: Due date completion status\n  \"idMembers\": \"string[]?\", // Optional: Array of member IDs to assign\n  \"idLabels\": \"string[]?\",  // Optional: Array of label IDs to attach\n  \"urlSource\": \"string?\",   // Optional: URL to create card from\n  \"address\": \"string?\",     // Optional: Physical address\n  \"locationName\": \"string?\", // Optional: Location name\n  \"coordinates\": \"string?\"  // Optional: Geographic coordinates (lat,lng)\n}\n```\n\n### `copy_card`\nCreate a card as a copy of an existing one — the way to use a template card. Trello copies\ndescription, labels, checklists and custom field values itself, so nothing has to be transcribed.\n\n```typescript\n// Parameters\n{\n  \"idCardSource\": \"string\",  // Required: ID of the card to copy (e.g. a template card)\n  \"idList\": \"string\",        // Required: Trello list ID for the copy\n  \"name\": \"string?\",         // Optional: Title of the copy (defaults to the source card's title)\n  \"desc\": \"string?\",         // Optional: Description, replacing the source card's (Markdown)\n  \"pos\": \"number|'top'|'bottom'?\", // Optional: Position in list\n  \"keepFromSource\": \"string?\" // Optional: 'all' (default) or a comma-separated subset of\n                              // attachments, checklists, comments, customFields, due, labels,\n                              // members, start, stickers\n}\n```\n\nMembers and due dates are copied only if `keepFromSource` says so — with the default `all`, they\nare. Pass an explicit subset to leave them behind:\n\n```bash\ntrello copy_card <templateCardId> <listId> \\\n  --name \"Documentation URL per Role\" \\\n  --keep-from-source checklists,customFields,labels\n```\n\n`--desc` replaces the template's description while the copy still carries its labels, checklists\nand custom field values — so a filled card is one write, not a create followed by an update.\n\n`idCardSource` accepts the short link from a `https://trello.com/c/<shortLink>` URL as well as the\nfull ID — the CLI resolves it, where the Trello API itself answers a short link with a bare\n`Invalid objectId`.\n\nCards carry `isTemplate` in every read (`get_board_cards`, `get_card_details`, `search_cards`), so\na board's template cards are discoverable rather than a hard-coded ID.\n\n### `update_card`\nUpdate an existing Trello card. All fields are optional except cardId.\n\n```typescript\n// Parameters\n{\n  \"cardId\": \"string\",       // Required: Card ID to update\n  \"name\": \"string?\",        // Optional: New card title\n  \"desc\": \"string?\",        // Optional: New description (supports Markdown)\n  \"closed\": \"boolean?\",     // Optional: Archive status (true/false)\n  \"idList\": \"string?\",      // Optional: Move to different list\n  \"idMembers\": \"string[]?\", // Optional: Replace assigned members\n  \"idLabels\": \"string[]?\",  // Optional: Replace attached labels\n  \"pos\": \"number|'top'|'bottom'?\", // Optional: New position\n  \"due\": \"string|null?\",    // Optional: Due date or null to remove\n  \"dueComplete\": \"boolean?\", // Optional: Mark due date complete\n  \"subscribed\": \"boolean?\", // Optional: Subscribe to updates\n  \"address\": \"string?\",     // Optional: Physical address\n  \"locationName\": \"string?\", // Optional: Location name\n  \"coordinates\": \"string?\"  // Optional: Geographic coordinates (lat,lng)\n}\n```\n\n### `get_board_cards`\nRetrieve all cards from a specific Trello board with comprehensive metadata.\n\n```typescript\n// Parameters\n{\n  \"boardId\": \"string\" // Trello board ID\n}\n```\n\n### `get_card_details`\nGet detailed information about a specific card including members, checklists, and attachments.\n\n```typescript\n// Parameters\n{\n  \"cardId\": \"string\" // Trello card ID\n}\n```\n\n### `get_card_comments`\nFetch all comments and discussion history for a card.\n\n```typescript\n// Parameters\n{\n  \"cardId\": \"string\" // Trello card ID\n}\n```\n\n### `add_card_comment`\nPost a new comment to a Trello card for team collaboration.\n\n```typescript\n// Parameters\n{\n  \"cardId\": \"string\", // Trello card ID\n  \"comment\": \"string\" // Comment text to add\n}\n```\n\n### `search_cards`\nSearch for cards across boards or within specific projects.\n\n```typescript\n// Parameters\n{\n  \"query\": \"string\",     // Search query\n  \"boardId\": \"string?\"   // Optional: limit to specific board\n}\n```\n\n### `get_board_lists`\nRetrieve all lists from a Trello board.\n\n```typescript\n// Parameters\n{\n  \"boardId\": \"string\" // Trello board ID\n}\n```\n\n### `create_list`\nCreate a new list on a Trello board.\n\n```typescript\n// Parameters\n{\n  \"name\": \"string\",         // Required: List name\n  \"idBoard\": \"string\",      // Required: Trello board ID\n  \"pos\": \"number|'top'|'bottom'?\" // Optional: Position in board\n}\n```\n\n### `get_board_labels`\nRetrieve all labels from a Trello board.\n\n```typescript\n// Parameters\n{\n  \"boardId\": \"string\" // Trello board ID\n}\n```\n\n### `create_label`\nCreate a new label on a Trello board.\n\n```typescript\n// Parameters\n{\n  \"name\": \"string\",         // Required: Label name\n  \"idBoard\": \"string\",      // Required: Trello board ID\n  \"color\": \"yellow|purple|blue|red|green|orange|black|sky|pink|lime?\" // Optional: Label color\n}\n```\n\n### `get_card_checklists`\nGet all checklists (with their items) on a Trello card.\n\n```typescript\n// Parameters\n{\n  \"cardId\": \"string\"        // Required: Trello card ID\n}\n```\n\n### `create_checklist`\nCreate a checklist on a card. Optionally seed it with initial items in one call.\n\n```typescript\n// Parameters\n{\n  \"idCard\": \"string\",                  // Required: Card ID to attach the checklist to\n  \"name\": \"string\",                    // Required: Checklist name\n  \"pos\": \"number|'top'|'bottom'?\",     // Optional: Position on the card\n  \"items\": \"string[]?\"                 // Optional: Initial items (created in order, unchecked)\n}\n```\n\n### `add_checklist_item`\nAdd an item to an existing checklist.\n\n```typescript\n// Parameters\n{\n  \"idChecklist\": \"string\",             // Required: Checklist ID\n  \"name\": \"string\",                    // Required: Item text\n  \"pos\": \"number|'top'|'bottom'?\",     // Optional: Position within the checklist\n  \"checked\": \"boolean?\"                // Optional: Initial checked state (default false)\n}\n```\n\n### `update_checklist_item`\nUpdate a checklist item — rename, mark complete/incomplete, or reorder.\n\n```typescript\n// Parameters\n{\n  \"idCard\": \"string\",                  // Required: Card ID containing the checklist\n  \"idCheckItem\": \"string\",             // Required: Checklist item ID\n  \"name\": \"string?\",                   // Optional: New text\n  \"state\": \"'complete'|'incomplete'?\", // Optional: Completion state\n  \"pos\": \"number|'top'|'bottom'?\"      // Optional: New position\n}\n```\n\n### `delete_checklist`\nDelete a checklist (and all its items) from a card.\n\n```typescript\n// Parameters\n{\n  \"idChecklist\": \"string\"   // Required: Checklist ID\n}\n```\n\n### `attach_card_link`\nAttach a URL to a card. When the URL points to another Trello card (`https://trello.com/c/<shortLink>`), Trello renders it as a card-preview chip in the sidebar — useful for cross-linking related cards.\n\n```typescript\n// Parameters\n{\n  \"idCard\": \"string\",   // Required: Card to attach the link to\n  \"url\": \"string\",      // Required: URL (use a Trello card URL for cross-links)\n  \"name\": \"string?\"     // Optional: display name for the attachment\n}\n```\n\n### `attach_card_file`\nUpload a local file from disk as an attachment on a card (images, PDFs, logs, etc.). To attach a URL instead, use `attach_card_link`.\n\n```typescript\n// Parameters\n{\n  \"idCard\": \"string\",     // Required: Card to attach the file to\n  \"filePath\": \"string\",   // Required: Absolute path to the local file to upload\n  \"name\": \"string?\",      // Optional: display name (defaults to the file's name)\n  \"mimeType\": \"string?\"   // Optional: MIME type (e.g. \"image/png\"); inferred when omitted\n}\n```\n\n### `get_card_attachments`\nGet all attachments on a card.\n\n```typescript\n// Parameters\n{\n  \"cardId\": \"string\"   // Required: Card ID\n}\n```\n\n## Example Workflows\n\n### Card Creation\n```\nCreate a new card in list 507f191e810c19729de860ea titled \"Implement new feature\" with description \"Add authentication system\" assigned to member 5a2e4b6c8d9e1f2a3b4c5d6e and due date 2024-12-31\n```\n\n### Card Updates\n```\nUpdate card abc123 to change title to \"Authentication Complete\", mark due date as complete, and move to list 507f191e810c19729de860eb\n```\n\n### Project Analysis\n```\nAnalyze all cards in board 507f1f77bcf86cd799439011 and summarize project status\n```\n\n### Task Management\n```\nFind all overdue cards across my boards and add status update comments\n```\n\n### Team Collaboration\n```\nGet comments from card abc123 and suggest next steps based on the discussion\n```\n\n### Automated Workflows\n```\nCreate a card for each action item from meeting notes, assign to relevant team members, and set due dates\n```\n\n### List Management\n```\nCreate a new list on board 507f1f77bcf86cd799439011 named \"In Review\" positioned at the top\n```\n\n### Label Organization\n```\nGet all labels from board 507f1f77bcf86cd799439011 and create a new \"High Priority\" label with red color\n```\n\n## Development\n\n### Local Development\n\n```bash\n# Clone and setup\ngit clone git@github.com:wachterjohannes/trello-mcp.git\ncd trello-mcp\nnpm install\n\n# Set environment variables\ncp .env.example .env\n# Edit .env with your Trello credentials\n\n# Build and run\nnpm run build\nnpm start\n```\n\n### Available Scripts\n\n- `npm run build` - Compile TypeScript to JavaScript\n- `npm run dev` - Development mode with watch\n- `npm start` - Run the compiled server\n- `npm run trello` - Run the CLI (e.g. `npm run trello -- list`)\n- `npm test` - Build and run the test suite\n- `npm run lint` - Run ESLint\n\n### Project Architecture\n\n```\nsrc/\n├── tools.ts           # Tool registry shared by the MCP server and the CLI\n├── index.ts           # MCP server (stdio); delegates to the CLI when given arguments\n├── cli.ts             # Command line interface: parsing, help, output\n├── script.ts          # JSON script runner with step chaining\n├── setup.ts           # `trello setup`: authentication + skill installation\n├── config.ts          # Stored credentials and token verification\n├── skills.ts          # Agent-root detection and skill installation\n├── install-skills.ts  # postinstall entry point (global installs only)\n└── trello-client.ts   # Trello API client with TypeScript interfaces\nskills/trello-cli/     # Bundled agent skill, installed into agent roots\n```\n\nAdding a tool means adding one entry to `src/tools.ts` — it then appears in the\nMCP server, `trello list`, the CLI help and the script runner at once.\n\n## Security\n\n- API credentials are never logged or exposed\n- Environment-based authentication prevents credential leakage\n- Comprehensive input validation on all tool parameters\n- Secure handling of Trello API responses\n\n## Troubleshooting\n\n### Common Issues\n\n**Authentication Errors**\n```bash\nError: TRELLO_API_KEY and TRELLO_TOKEN environment variables are required\n```\n→ Ensure your API credentials are properly set in environment variables\n\n**Invalid Board/Card IDs**\n```bash\nError: Failed to get board cards: Request failed with status code 400\n```\n→ Verify the board or card ID exists and you have access permissions\n\n**Rate Limiting**\n```bash\nError: Request failed with status code 429\n```\n→ Trello API rate limits apply; implement retry logic or reduce request frequency\n\n## Publishing\n\nThis package is published to npm as `@asapo/trello-mcp-server`. To publish updates:\n\n```bash\nnpm version patch|minor|major\nnpm publish\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Commit changes: `git commit -m 'Add amazing feature'`\n4. Push to branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.","readmeFilename":"README.md"}