{"_id":"@cnx-tandem/trello-mcp-server","name":"@cnx-tandem/trello-mcp-server","dist-tags":{"latest":"1.8.0"},"versions":{"1.8.0":{"name":"@cnx-tandem/trello-mcp-server","mcpName":"io.github.jacobjonestx/trello-mcp-server","version":"1.8.0","description":"A token-efficient MCP server for Trello boards with search and field-filtering capabilities.","keywords":["mcp","trello","bun","automation","productivity","model-context-protocol","api","integration","typescript","board-management","task-management","kanban"],"author":{"name":"Jacob Jones"},"license":"MIT","bugs":{"url":"https://github.com/JacobJonesTX/trello-mcp-server/issues"},"homepage":"https://github.com/JacobJonesTX/trello-mcp-server#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.24.3","axios":"^1.13.2","form-data":"^4.0.5","mcp-evals":"^1.0.18","zod":"^3.25.76"},"devDependencies":{"@ai-sdk/openai":"^1.3.24","bun-types":"latest","@typescript-eslint/eslint-plugin":"^6.21.0","@typescript-eslint/parser":"^6.21.0","eslint":"^8.57.1","eslint-config-prettier":"^9.1.2","eslint-plugin-prettier":"^5.5.4","prettier":"^3.7.4","terser":"^5.44.1","typescript":"^5.9.3"},"bin":{"trello-mcp-server":"build/index.js"},"type":"module","engines":{"bun":">=1.0.0"},"publishConfig":{"access":"public"},"scripts":{"build":"bun build src/index.ts --outdir ./build --target node --format esm","build:types":"tsc --emitDeclarationOnly || echo 'Warning: Type declarations generation failed, but build succeeded'","build:prod":"npm run build","dev":"bun --watch src/index.ts","versionbump":"bun ./scripts/versionbump.js","versionbump:patch":"bun run versionbump --patch","versionbump:minor":"bun run versionbump --minor","versionbump:major":"bun run versionbump --major","publish":"bun run build && npm publish"},"_id":"@cnx-tandem/trello-mcp-server@1.8.0","gitHead":"90951a7c5a2b6c556e92fbe34ce9b8d0ecc74549","_nodeVersion":"20.16.0","_npmVersion":"10.8.1","dist":{"integrity":"sha512-/dj9gSL5je2QhF6vHL4AvFfiQA+OuaWAkuYKhRsX2lAUS6G+HVDUpG6H9LrfFgUL2DMwlC3UQhbNs6Hapj8QfA==","shasum":"77744915ab7a87801fd5f3d3a3b8bc0e165a6d1a","tarball":"https://registry.npmjs.org/@cnx-tandem/trello-mcp-server/-/trello-mcp-server-1.8.0.tgz","fileCount":4,"unpackedSize":1380490,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCkVHilLTbK04O9Rwp/d83LHVTss+xYtK7l4uAIN4hMeAIhAMZuJ3RPrvMOe3D9yUU/dWEFpfOk0Tjd4ZY5U/ofXiRG"}]},"_npmUser":{"name":"jacobjonestx","email":"jjones@tandem.app"},"directories":{},"maintainers":[{"name":"jacobjonestx","email":"jjones@tandem.app"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/trello-mcp-server_1.8.0_1771626960706_0.6597778853421683"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-20T22:36:00.507Z","1.8.0":"2026-02-20T22:36:00.892Z","modified":"2026-02-20T22:36:01.162Z"},"maintainers":[{"name":"jacobjonestx","email":"jjones@tandem.app"}],"description":"A token-efficient MCP server for Trello boards with search and field-filtering capabilities.","homepage":"https://github.com/JacobJonesTX/trello-mcp-server#readme","keywords":["mcp","trello","bun","automation","productivity","model-context-protocol","api","integration","typescript","board-management","task-management","kanban"],"author":{"name":"Jacob Jones"},"bugs":{"url":"https://github.com/JacobJonesTX/trello-mcp-server/issues"},"license":"MIT","readme":"# MCP Server Trello (Token-Efficient Fork)\n\n> **Fork of [delorenj/mcp-server-trello](https://github.com/delorenj/mcp-server-trello)** with token efficiency improvements for LLM-based MCP clients.\n\n[![npm version](https://badge.fury.io/js/%40jacobjonestx%2Ftrello-mcp-server.svg)](https://badge.fury.io/js/%40jacobjonestx%2Ftrello-mcp-server)\n\nA 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.\n\n## What's Different in This Fork\n\nThe upstream server forces AI agents to download entire board contents to find a single card — listing all boards, then all lists, then all cards per list with every field. A real-world search across 3 boards consumed **~606K cache creation tokens** and **~4.6M cache read tokens** across 72 API turns.\n\nThis fork adds search and field-filtering capabilities that reduce token usage by **~90-99%** for common workflows:\n\n| Change                                       | Impact                                                                                                      |\n| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |\n| **`search_cards` tool** (new)                | Search by keyword instead of scanning every list. Uses the Trello Search API (`GET /1/search`).             |\n| **`search_boards` tool** (new)               | Find boards by name instead of listing all with full metadata.                                              |\n| **`get_list_card_count` tool** (new)         | Get card counts per list without downloading card data. Helps agents decide which lists to explore.         |\n| **`fields` param on `get_cards_by_list_id`** | Request only the fields you need (e.g., `\"name,shortUrl\"`). A card that returns ~2,000 chars drops to ~150. |\n| **`fields` param on `list_boards`**          | Request only `\"name,shortUrl\"` instead of full board objects. ~88K chars drops to ~2K.                      |\n\n### Estimated Token Savings\n\n| Scenario                            | Before           | After            | Reduction |\n| ----------------------------------- | ---------------- | ---------------- | --------- |\n| Find a specific card by keyword     | ~600K+ tokens    | ~5K tokens       | ~99%      |\n| List all boards (names only)        | ~88K chars       | ~2K chars        | ~98%      |\n| Browse cards in a list (names only) | ~200K-700K chars | ~5K-15K chars    | ~97%      |\n| Understand board structure          | Full card fetch  | Card counts only | ~99%      |\n\n## Changelog\n\nFor a detailed list of changes, please refer to the [CHANGELOG.md](CHANGELOG.md) file.\n\n## Features\n\n- **Full Trello Board Integration**: Interact with cards, lists, and board activities\n- **🆕 Complete Card Data Extraction**: Fetch all card details including checklists, attachments, labels, members, and comments\n- **💬 Comment Management**: Add, update, delete, and retrieve comments on cards\n- **File Attachments**: Attach any type of file to cards (PDFs, documents, videos, images, etc.) from URLs\n- **Built-in Rate Limiting**: Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token)\n- **Type-Safe Implementation**: Written in TypeScript with comprehensive type definitions\n- **Input Validation**: Robust validation for all API inputs\n- **Error Handling**: Graceful error handling with informative messages\n- **Dynamic Board Selection**: Switch between boards and workspaces without restarting\n- **Markdown Formatting**: Export card data in human-readable markdown format\n\n## Installation\n\n### 🚀 Install from MCP Registry (Recommended)\n\nThe MCP Server Trello is now available in the official MCP Registry\\! MCP clients can automatically discover and install this server.\n\nFor clients that support the MCP Registry:\n\n1.  Search for \"trello-mcp-server\" or \"io.github.jacobjonestx/trello-mcp-server\"\n2.  Install directly from the registry\n3.  Configure with your Trello credentials\n\n### 🚀 Quick Start with Bun (Fastest)\n\nIf you have [Bun](https://bun.sh) installed, using `bunx` is the fastest way to run the server:\n\n```json\n{\n  \"mcpServers\": {\n    \"trello\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@cnx-tandem/trello-mcp-server\"],\n      \"env\": {\n        \"TRELLO_API_KEY\": \"your-api-key\",\n        \"TRELLO_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n### Quick Start with npx / pnpx / bunx\n\nYou can still use `npx` or `pnpx`. This doesn't require a global install and will work just fine, though `bunx` (above) is faster.\n\n```json\n{\n  \"mcpServers\": {\n    \"trello\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@cnx-tandem/trello-mcp-server\"],\n      \"env\": {\n        \"TRELLO_API_KEY\": \"your-api-key\",\n        \"TRELLO_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\nOr if you're using mise, you can explicitly execute `bunx` with `mise exec`:\n\n```json\n{\n  \"mcpServers\": {\n    \"trello\": {\n      \"command\": \"mise\",\n      \"args\": [\"x\", \"--\", \"bunx\", \"@cnx-tandem/trello-mcp-server\"],\n      \"env\": {\n        \"TRELLO_API_KEY\": \"your-api-key\",\n        \"TRELLO_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\nTo connect a Trello workspace, you'll need to manually retrieve a `TRELLO_TOKEN` once per workspace. After setting up your Trello Power-Up, visit the following URL:\n\n```\nhttps://trello.com/1/authorize?expiration=never&name=YOUR_APP_NAME&scope=read,write&response_type=token&key=YOUR_API_KEY\n```\n\nReplace:\n\n- `YOUR_APP_NAME` with a name for your application (e.g., \"My Trello Integration\"). This name is shown to the user on the Trello authorization screen.\n- `YOUR_API_KEY` with the API key for your Trello Power-Up\n\nThis will generate the token required for integration.\n\n> [\\!NOTE]\n> The `expiration=never` parameter creates a token that does not expire. For enhanced security, consider using `expiration=30days` and renewing the token periodically if your setup allows for it.\n\n#### Don't have Bun?\n\nThe simplest way to get `bun` (and thus `bunx`) is through [mise](https://mise.jdx.dev/):\n\n```bash\n# Install mise (if you don't have it)\ncurl https://mise.run | sh\n\n# Install bun and make the @latest version your system default\nmise use bun@latest -g\n\n# Or just run `mise install` from the project directory to install Bun locally\ncd /path/to/mcp-server-trello\nmise install\n```\n\n### Installing via npm\n\nIf you prefer using `npm` directly:\n\n```bash\nnpm install -g @cnx-tandem/trello-mcp-server\n```\n\n_(A fast alternative is `bun add -g @cnx-tandem/trello-mcp-server`)_\n\nThen use `npx trello-mcp-server` as the command in your MCP configuration.\n\n### Installing via Smithery\n\nTo install Trello Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@cnx-tandem/trello-mcp-server):\n\n```bash\n# Using bunx (recommended)\nbunx -y @smithery/cli install @cnx-tandem/trello-mcp-server --client claude\n\n# Using npx\nnpx -y @smithery/cli install @cnx-tandem/trello-mcp-server --client claude\n```\n\n### Docker Installation\n\nFor containerized environments:\n\n1.  Clone the repository:\n\n<!-- end list -->\n\n```bash\ngit clone https://github.com/JacobJonesTX/trello-mcp-server\ncd trello-mcp-server\n```\n\n2.  Copy the environment template and fill in your Trello credentials:\n\n<!-- end list -->\n\n```bash\ncp .env.template .env\n```\n\n3.  Build and run with Docker Compose:\n\n<!-- end list -->\n\n```bash\ndocker compose up --build\n```\n\n## Configuration\n\n### Environment Variables\n\nThe server can be configured using environment variables. Create a `.env` file in the root directory with the following variables:\n\n```env\n# Required: Your Trello API credentials\nTRELLO_API_KEY=your-api-key\nTRELLO_TOKEN=your-token\n\n# Optional (Deprecated): Default board ID (can be changed later using set_active_board)\nTRELLO_BOARD_ID=your-board-id\n\n# Optional: Initial workspace ID (can be changed later using set_active_workspace)\nTRELLO_WORKSPACE_ID=your-workspace-id\n```\n\nYou can get these values from:\n\n- API Key: [https://trello.com/app-key](https://trello.com/app-key)\n- Token: Generate using your API key\n- Board ID (optional, deprecated): Found in the board URL (e.g., [suspicious link removed])\n- Workspace ID: Found in workspace settings or using `list_workspaces` tool\n\n### Board and Workspace Management\n\nStarting with version 0.3.0, the MCP server supports multiple ways to work with boards:\n\n1.  **Multi-board support**: All methods now accept an optional `boardId` parameter\n    - Omit `TRELLO_BOARD_ID` and provide `boardId` in each API call\n    - Set `TRELLO_BOARD_ID` as default and optionally override with `boardId` parameter\n\n2.  **Dynamic board selection**: Use workspace management tools\n    - The `TRELLO_BOARD_ID` in your `.env` file is used as the initial/default board ID\n    - You can change the active board at any time using the `set_active_board` tool\n    - The selected board persists between server restarts (stored in `~/.trello-mcp/config.json`)\n    - Similarly, you can set and persist an active workspace using `set_active_workspace`\n\nThis allows you to work with multiple boards and workspaces without restarting the server.\n\n#### Example Workflow\n\n1.  Start by listing available boards:\n\n<!-- end list -->\n\n```typescript\n{\n  name: 'list_boards',\n  arguments: {}\n}\n```\n\n2.  Set your active board:\n\n<!-- end list -->\n\n```typescript\n{\n  name: 'set_active_board',\n  arguments: {\n    boardId: \"abc123\"  // ID from list_boards response\n  }\n}\n```\n\n3.  List workspaces if needed:\n\n<!-- end list -->\n\n```typescript\n{\n  name: 'list_workspaces',\n  arguments: {}\n}\n```\n\n4.  Set active workspace if needed:\n\n<!-- end list -->\n\n```typescript\n{\n  name: 'set_active_workspace',\n  arguments: {\n    workspaceId: \"xyz789\"  // ID from list_workspaces response\n  }\n}\n```\n\n5.  Check current active board info:\n\n<!-- end list -->\n\n```typescript\n{\n  name: 'get_active_board_info',\n  arguments: {}\n}\n```\n\n## Date Format Guidelines\n\nWhen working with dates in the Trello MCP server, please note the different format requirements:\n\n- **Due Date (`dueDate`)**: Accepts full ISO 8601 format with time (e.g., `2023-12-31T12:00:00Z`)\n- **Start Date (`start`)**: Accepts date only in YYYY-MM-DD format (e.g., `2025-08-05`)\n\nThis distinction follows Trello's API conventions where start dates are day-based markers while due dates can include specific times.\n\n## Available Tools\n\n### Checklist Management Tools 🆕\n\n#### get_checklist_items\n\nGet all items from a checklist by name.\n\n```typescript\n{\n  name: 'get_checklist_items',\n  arguments: {\n    name: string,        // Name of the checklist to retrieve items from\n    boardId?: string     // Optional: ID of the board (uses default if not provided)\n  }\n}\n```\n\n#### add_checklist_item\n\nAdd a new item to an existing checklist.\n\n```typescript\n{\n  name: 'add_checklist_item',\n  arguments: {\n    text: string,           // Text content of the checklist item\n    checkListName: string,  // Name of the checklist to add the item to\n    boardId?: string        // Optional: ID of the board (uses default if not provided)\n  }\n}\n```\n\n#### find_checklist_items_by_description\n\nSearch for checklist items containing specific text.\n\n```typescript\n{\n  name: 'find_checklist_items_by_description',\n  arguments: {\n    description: string,  // Text to search for in checklist item descriptions\n    boardId?: string      // Optional: ID of the board (uses default if not provided)\n  }\n}\n```\n\n#### get_acceptance_criteria\n\nGet all items from the \"Acceptance Criteria\" checklist.\n\n```typescript\n{\n  name: 'get_acceptance_criteria',\n  arguments: {\n    boardId?: string  // Optional: ID of the board (uses default if not provided)\n  }\n}\n```\n\n#### get_checklist_by_name\n\nGet a complete checklist with all items and completion percentage.\n\n```typescript\n{\n  name: 'get_checklist_by_name',\n  arguments: {\n    name: string,     // Name of the checklist to retrieve\n    boardId?: string  // Optional: ID of the board (uses default if not provided)\n  }\n}\n```\n\n**Returns:** `CheckList` object with:\n\n- `id`: Checklist identifier\n- `name`: Checklist name\n- `items`: Array of `CheckListItem` objects\n- `percentComplete`: Completion percentage (0-100)\n\n### get_card 🆕\n\nGet comprehensive details of a specific Trello card with human-level parity.\n\n```typescript\n{\n  name: 'get_card',\n  arguments: {\n    cardId: string,          // ID of the Trello card (short ID like 'FdhbArbK' or full ID)\n    includeMarkdown?: boolean // Return formatted markdown instead of JSON (default: false)\n  }\n}\n```\n\n**Returns:** Complete card data including:\n\n- ✅ Checklists with item states and assignments\n- 📎 Attachments with previews and metadata\n- 🏷️ Labels with names and colors\n- 👥 Assigned members\n- 💬 Comments and activity\n- 📊 Statistics (badges)\n- 🎨 Cover images\n- 📍 Board and list context\n\n### search_cards 🆕\n\nSearch for cards across boards by keyword. Uses the Trello Search API to find cards matching the query text in card names, descriptions, comments, and checklists — without scanning every list.\n\n```typescript\n{\n  name: 'search_cards',\n  arguments: {\n    query: string,        // Search query text. Supports Trello search operators (e.g., 'name:', 'label:', 'is:open')\n    boardId?: string,     // Optional: Limit search to a specific board ID (uses active board if not provided)\n    cardFields?: string,  // Optional: Comma-separated card fields to return (default: 'name,desc,shortUrl,idList,labels,due,dateLastActivity')\n    cardsLimit?: number,  // Optional: Max cards to return, 1-1000 (default: 10)\n    partial?: boolean     // Optional: Enable prefix matching (default: true)\n  }\n}\n```\n\n### search_boards 🆕\n\nSearch for boards by name or keyword instead of listing all boards with full metadata.\n\n```typescript\n{\n  name: 'search_boards',\n  arguments: {\n    query: string,         // Search query text\n    boardFields?: string,  // Optional: Comma-separated board fields to return (default: 'name,shortUrl')\n    boardsLimit?: number   // Optional: Max boards to return (default: 10)\n  }\n}\n```\n\n### get_list_card_count 🆕\n\nGet the number of cards in each list on a board without fetching card details. Useful for understanding board structure before deciding which lists to explore.\n\n```typescript\n{\n  name: 'get_list_card_count',\n  arguments: {\n    boardId?: string  // Optional: Board ID (uses active board if not provided)\n  }\n}\n```\n\n**Returns:** Array of `{ id, name, cardCount }` for each list on the board.\n\n### get_cards_by_list_id\n\nFetch all cards from a specific list.\n\n```typescript\n{\n  name: 'get_cards_by_list_id',\n  arguments: {\n    boardId?: string, // Optional: ID of the board (uses default if not provided)\n    listId: string,   // ID of the Trello list\n    fields?: string   // Optional: Comma-separated card fields to include (e.g., 'name,desc,shortUrl,labels'). Returns all fields if omitted.\n  }\n}\n```\n\n### get_lists\n\nRetrieve all lists from a board.\n\n```typescript\n{\n  name: 'get_lists',\n  arguments: {\n    boardId?: string  // Optional: ID of the board (uses default if not provided)\n  }\n}\n```\n\n### get_recent_activity\n\nFetch recent activity on a board.\n\n```typescript\n{\n  name: 'get_recent_activity',\n  arguments: {\n    boardId?: string, // Optional: ID of the board (uses default if not provided)\n    limit?: number    // Optional: Number of activities to fetch (default: 10)\n  }\n}\n```\n\n### add_card_to_list\n\nAdd a new card to a specified list.\n\n```typescript\n{\n  name: 'add_card_to_list',\n  arguments: {\n    boardId?: string,     // Optional: ID of the board (uses default if not provided)\n    listId: string,       // ID of the list to add the card to\n    name: string,         // Name of the card\n    description?: string, // Optional: Description of the card\n    dueDate?: string,     // Optional: Due date (ISO 8601 format with time)\n    start?: string,       // Optional: Start date (YYYY-MM-DD format, date only)\n    labels?: string[]     // Optional: Array of label IDs\n  }\n}\n```\n\n### update_card_details\n\nUpdate an existing card's details.\n\n```typescript\n{\n  name: 'update_card_details',\n  arguments: {\n    boardId?: string,     // Optional: ID of the board (uses default if not provided)\n    cardId: string,       // ID of the card to update\n    name?: string,        // Optional: New name for the card\n    description?: string, // Optional: New description\n    dueDate?: string,     // Optional: New due date (ISO 8601 format with time)\n    start?: string,       // Optional: New start date (YYYY-MM-DD format, date only)\n    dueComplete?: boolean,// Optional: Mark the due date as complete (true) or incomplete (false)\n    labels?: string[]     // Optional: New array of label IDs\n  }\n}\n```\n\n### archive_card\n\nSend a card to the archive.\n\n```typescript\n{\n  name: 'archive_card',\n  arguments: {\n    boardId?: string, // Optional: ID of the board (uses default if not provided)\n    cardId: string    // ID of the card to archive\n  }\n}\n```\n\n### add_list_to_board\n\nAdd a new list to a board.\n\n```typescript\n{\n  name: 'add_list_to_board',\n  arguments: {\n    boardId?: string, // Optional: ID of the board (uses default if not provided)\n    name: string      // Name of the new list\n  }\n}\n```\n\n### archive_list\n\nSend a list to the archive.\n\n```typescript\n{\n  name: 'archive_list',\n  arguments: {\n    boardId?: string, // Optional: ID of the board (uses default if not provided)\n    listId: string    // ID of the list to archive\n  }\n}\n```\n\n### get_my_cards\n\nFetch all cards assigned to the current user.\n\n```typescript\n{\n  name: 'get_my_cards',\n  arguments: {}\n}\n```\n\n### move_card\n\nMove a card to a different list.\n\n```typescript\n{\n  name: 'move_card',\n  arguments: {\n    boardId?: string,  // Optional: ID of the target board (uses default if not provided)\n    cardId: string,    // ID of the card to move\n    listId: string     // ID of the target list\n  }\n}\n```\n\n### attach_image_to_card\n\nAttach an image to a card directly from a URL.\n\n```typescript\n{\n  name: 'attach_image_to_card',\n  arguments: {\n    boardId?: string, // Optional: ID of the board (uses default if not provided)\n    cardId: string,   // ID of the card to attach the image to\n    imageUrl: string, // URL of the image to attach\n    name?: string     // Optional: Name for the attachment (defaults to \"Image Attachment\")\n  }\n}\n```\n\n### attach_file_to_card\n\nAttach any type of file to a card from a URL or a local file path (e.g., `file:///path/to/your/file.pdf`).\n\n```typescript\n{\n  name: 'attach_file_to_card',\n  arguments: {\n    boardId?: string,  // Optional: ID of the board (uses default if not provided)\n    cardId: string,    // ID of the card to attach the file to\n    fileUrl: string,   // URL or local file path (using the file:// protocol) of the file to attach\n    name?: string,     // Optional: Name for the attachment (defaults to the file name for local files)\n    mimeType?: string  // Optional: MIME type (e.g., \"application/pdf\", \"text/plain\", \"video/mp4\")\n  }\n}\n```\n\n### Comment Management Tools\n\n#### add_comment\n\nAdd a comment to a Trello card.\n\n```typescript\n{\n  name: 'add_comment',\n  arguments: {\n    cardId: string,  // ID of the card to comment on\n    text: string     // The text of the comment to add\n  }\n}\n```\n\n#### update_comment\n\nUpdate an existing comment on a card.\n\n```typescript\n{\n  name: 'update_comment',\n  arguments: {\n    commentId: string,  // ID of the comment to change\n    text: string        // The new text of the comment\n  }\n}\n```\n\n#### delete_comment\n\nDelete a comment from a card.\n\n```typescript\n{\n  name: 'delete_comment',\n  arguments: {\n    commentId: string  // ID of the comment to delete\n  }\n}\n```\n\n#### get_card_comments\n\nRetrieve all comments from a specific card without fetching all card data.\n\n```typescript\n{\n  name: 'get_card_comments',\n  arguments: {\n    cardId: string,  // ID of the card to get comments from\n    limit?: number   // Optional: Maximum number of comments to retrieve (default: 100)\n  }\n}\n```\n\n### list_boards\n\nList all boards the user has access to.\n\n```typescript\n{\n  name: 'list_boards',\n  arguments: {\n    fields?: string  // Optional: Comma-separated board fields to include (e.g., 'name,shortUrl'). Returns all fields if omitted.\n  }\n}\n```\n\n### set_active_board\n\nSet the active board for future operations.\n\n```typescript\n{\n  name: 'set_active_board',\n  arguments: {\n    boardId: string  // ID of the board to set as active\n  }\n}\n```\n\n### list_workspaces\n\nList all workspaces the user has access to.\n\n```typescript\n{\n  name: 'list_workspaces',\n  arguments: {}\n}\n```\n\n### set_active_workspace\n\nSet the active workspace for future operations.\n\n```typescript\n{\n  name: 'set_active_workspace',\n  arguments: {\n    workspaceId: string  // ID of the workspace to set as active\n  }\n}\n```\n\n### list_boards_in_workspace\n\nList all boards in a specific workspace.\n\n```typescript\n{\n  name: 'list_boards_in_workspace',\n  arguments: {\n    workspaceId: string  // ID of the workspace to list boards from\n  }\n}\n```\n\n### get_active_board_info\n\nGet information about the currently active board.\n\n```typescript\n{\n  name: 'get_active_board_info',\n  arguments: {}\n}\n```\n\n## Integration Examples\n\n### 🎨 Pairing with Ideogram MCP Server\n\nThe Trello MCP server pairs beautifully with [@flowluap/ideogram-mcp-server](https://github.com/flowluap/ideogram-mcp-server) for AI-powered visual content creation. Generate images with Ideogram and attach them directly to your Trello cards\\!\n\n#### Example Workflow\n\n1.  **Generate an image with Ideogram:**\n\n<!-- end list -->\n\n```typescript\n// Using ideogram-mcp-server\n{\n  name: 'generate_image',\n  arguments: {\n    prompt: \"A futuristic dashboard design with neon accents\",\n    aspect_ratio: \"16:9\"\n  }\n}\n// Returns: { image_url: \"https://...\" }\n```\n\n2.  **Attach the generated image to a Trello card:**\n\n<!-- end list -->\n\n```typescript\n// Using trello-mcp-server\n{\n  name: 'attach_image_to_card',\n  arguments: {\n    cardId: \"your-card-id\",\n    imageUrl: \"https://...\", // URL from Ideogram\n    name: \"Dashboard Mockup v1\"\n  }\n}\n```\n\n#### Setting up both servers\n\nAdd both servers to your Claude Desktop configuration. Use `bunx` for the fastest startup.\n\n```json\n{\n  \"mcpServers\": {\n    \"trello\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@cnx-tandem/trello-mcp-server\"],\n      \"env\": {\n        \"TRELLO_API_KEY\": \"your-trello-api-key\",\n        \"TRELLO_TOKEN\": \"your-trello-token\"\n      }\n    },\n    \"ideogram\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@flowluap/ideogram-mcp-server\"],\n      \"env\": {\n        \"IDEOGRAM_API_KEY\": \"your-ideogram-api-key\"\n      }\n    }\n  }\n}\n```\n\nNow you can seamlessly create visual content and organize it in Trello, all within Claude\\!\n\n## Rate Limiting\n\nThe server implements a token bucket algorithm for rate limiting to comply with Trello's API limits:\n\n- 300 requests per 10 seconds per API key\n- 100 requests per 10 seconds per token\n\nRate limiting is handled automatically, and requests will be queued if limits are reached.\n\n## Error Handling\n\nThe server provides detailed error messages for various scenarios:\n\n- Invalid input parameters\n- Rate limit exceeded\n- API authentication errors\n- Network issues\n- Invalid board/list/card IDs\n\n## Development\n\n### Prerequisites\n\n- [Bun](https://bun.sh) (v1.0.0 or higher)\n\n### Setup\n\n1.  Clone the repository\n\n<!-- end list -->\n\n```bash\ngit clone https://github.com/JacobJonesTX/trello-mcp-server\ncd trello-mcp-server\n```\n\n2.  Install dependencies\n\n<!-- end list -->\n\n```bash\nbun install\n```\n\n3.  Build the project\n\n<!-- end list -->\n\n```bash\nbun run build\n```\n\n## Running tests\n\nTo run the tests, run the following command:\n\n```bash\nbun test\n```\n\n## Running evals\n\nThe evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the `bunx` command. Full documentation can be found [here](https://www.mcpevals.io/docs).\n\n```bash\nOPENAI_API_KEY=your-key bunx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## Contributing\n\nContributions are welcome\\!\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://www.google.com/search?q=LICENSE) file for details.\n\n## Acknowledgments\n\n- Built with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n- Uses the [Trello REST API](https://developer.atlassian.com/cloud/trello/rest/)\n","readmeFilename":"README.md","_rev":"1-fdb2f4f4f588d64bdfa87e110ddc2692"}