{"skill":{"slug":"trello-projects","displayName":"Trello Projects","summary":"Manage Trello boards, lists, cards, comments, labels, checklists, and project workflows via the Trello API. Use this skill when users want to create boards,...","description":"---\nname: trello-projects\ndescription: Manage Trello boards, lists, cards, comments, labels, checklists, and project workflows via the Trello API. Use this skill when users want to create boards, manage cards, track tasks, or automate Trello project management workflows.\n---\n\n# Trello Projects\n\n![Trello Projects](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/trello.svg?v=2)\n\nManage Trello boards, lists, cards, comments, labels, checklists, members, and project workflows from chat via the Trello API.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=trello-projects) for hosted connection flows and credentials so you do not need to configure Trello API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Trello |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Trello |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│   Trello API     │\n│   (User Chat)   │     │   (OAuth)    │     │                  │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Trello   │                       │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │  Trello │\n   │  File    │           │ Auth     │           │ Account │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Trello again.\"\n\n## Quick Start\n\n```bash\n# List boards\nclawlink_call_tool --tool \"trello_get_boards\" --params '{}'\n\n# Get a board with lists and cards\nclawlink_call_tool --tool \"trello_get_board\" --params '{\"board_id\": \"BOARD_ID\"}'\n\n# Create a card\nclawlink_call_tool --tool \"trello_add_card\" --params '{\"id_list\": \"LIST_ID\", \"name\": \"New task\"}'\n```\n\n## Authentication\n\nAll Trello tool calls are authenticated automatically by ClawLink using the user's connected Trello account OAuth token.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Trello API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=trello and connect Trello.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `trello` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration trello\n```\n\n**Response:** Returns the live tool catalog for Trello.\n\n### Reconnect\n\nIf Trello tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=trello\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration trello`\n\n## Security & Permissions\n\n- Access is scoped to the Trello account connected during OAuth setup and the workspaces/boards accessible to that account.\n- **All write operations require explicit user confirmation.** Board deletion, card deletion, and list archiving are high-impact.\n- Confirm before bulk operations, member removals, or board deletions.\n- Board visibility and workspace permissions affect what operations are available.\n\n## Tool Reference\n\n### Boards\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_boards` | List all boards the member is associated with | Read |\n| `trello_get_board` | Get board details including lists, cards, and members | Read |\n| `trello_add_board` | Create a new board | Write |\n| `trello_update_board` | Update board name, description, or preferences | Write |\n| `trello_delete_board` | Permanently delete a board and all its contents | Write |\n| `trello_close_board` | Archive a board | Write |\n| `trello_get_board_actions` | Get recent actions on a board | Read |\n| `trello_get_board_labels` | List labels on a board | Read |\n| `trello_create_board_label` | Create a new label on a board | Write |\n| `trello_update_board_label` | Update a label's name or color | Write |\n| `trello_delete_board_label` | Delete a label from a board | Write |\n\n### Lists\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_lists` | List all lists on a board | Read |\n| `trello_add_list` | Create a new list on a board | Write |\n| `trello_update_list` | Update a list's name or position | Write |\n| `trello_archive_list` | Archive a list and all its cards | Write |\n| `trello_move_list` | Move a list to a different position | Write |\n| `trello_archive_all_list_cards` | Archive all cards in a list | Write |\n\n### Cards\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_cards` | List all cards on a board | Read |\n| `trello_get_card` | Get card details including description, members, and checklists | Read |\n| `trello_add_card` | Create a new card in a list | Write |\n| `trello_update_card` | Update a card's name, description, or position | Write |\n| `trello_move_card` | Move a card to a different list or position | Write |\n| `trello_delete_card` | Permanently delete an archived card | Write |\n| `trello_archive_card` | Archive a card | Write |\n| `trello_close_card` | Archive and close a card | Write |\n\n### Card Members & Labels\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_add_member_to_card` | Assign a member to a card | Write |\n| `trello_remove_member_from_card` | Remove a member from a card | Write |\n| `trello_add_label_to_card` | Add a label to a card | Write |\n| `trello_remove_label_from_card` | Remove a label from a card | Write |\n| `trello_create_card_label` | Create and add a new label to a card | Write |\n\n### Comments & Activity\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_card_comments` | List all comments on a card | Read |\n| `trello_add_comment` | Add a text comment with optional @mentions | Write |\n| `trello_delete_comment` | Delete a specific comment from a card | Write |\n| `trello_get_card_actions` | Get all actions on a card | Read |\n| `trello_add_reaction_to_action` | Add an emoji reaction to an action | Write |\n| `trello_delete_reaction_from_action` | Remove a reaction from an action | Write |\n\n### Checklists\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_card_checklists` | List all checklists on a card | Read |\n| `trello_add_checklist` | Add a checklist to a card | Write |\n| `trello_add_checklist_item` | Add an item to an existing checklist | Write |\n| `trello_toggle_checklist_item` | Toggle a checklist item's completion state | Write |\n| `trello_delete_checklist` | Delete a checklist from a card | Write |\n| `trello_delete_checklist_item` | Remove an item from a checklist | Write |\n| `trello_convert_checklist_item_to_card` | Convert a checklist item to a new card | Write |\n\n### Attachments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_card_attachments` | List all attachments on a card | Read |\n| `trello_add_attachment` | Add a file attachment or URL to a card | Write |\n| `trello_delete_attachment` | Remove an attachment from a card | Write |\n\n### Members\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_board_members` | List members on a board | Read |\n| `trello_add_member_to_board` | Invite a member to a board | Write |\n| `trello_remove_member_from_board` | Remove a member from a board | Write |\n| `trello_get_member` | Get a member's profile | Read |\n\n### Organizations (Workspaces)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_organizations` | List organizations the member belongs to | Read |\n| `trello_get_organization` | Get an organization's details | Read |\n| `trello_create_organization` | Create a new organization/workspace | Write |\n| `trello_update_organization` | Update an organization's settings | Write |\n| `trello_delete_organization` | Delete an organization | Write |\n\n### Power-Ups\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_get_board_power_ups` | List enabled Power-Ups on a board | Read |\n| `trello_enable_board_power_up` | Enable a Power-Up on a board | Write |\n| `trello_disable_board_power_up` | Disable a Power-Up on a board | Write |\n\n### Webhooks\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `trello_create_webhook` | Create a webhook for board/card changes | Write |\n| `trello_list_webhooks` | List all webhooks for the account | Read |\n| `trello_delete_webhook` | Delete a webhook | Write |\n\n## Code Examples\n\n### Get a board with all lists and cards\n\n```bash\nclawlink_call_tool --tool \"trello_get_board\" \\\n  --params '{\n    \"board_id\": \"BOARD_ID\"\n  }'\n```\n\n### Create a new card\n\n```bash\nclawlink_call_tool --tool \"trello_add_card\" \\\n  --params '{\n    \"id_list\": \"LIST_ID\",\n    \"name\": \"Review Q2 budget proposal\",\n    \"desc\": \"Please review and approve by Friday.\",\n    \"pos\": \"bottom\"\n  }'\n```\n\n### Add a checklist to a card\n\n```bash\nclawlink_call_tool --tool \"trello_add_checklist\" \\\n  --params '{\n    \"id_card\": \"CARD_ID\",\n    \"name\": \"Definition of Done\"\n  }'\n```\n\n### Add a comment with @mention\n\n```bash\nclawlink_call_tool --tool \"trello_add_comment\" \\\n  --params '{\n    \"id_card\": \"CARD_ID\",\n    \"text\": \"@JaneDoe please review the updated design by EOD.\"\n  }'\n```\n\n### Move a card to a different list\n\n```bash\nclawlink_call_tool --tool \"trello_move_card\" \\\n  --params '{\n    \"card_id\": \"CARD_ID\",\n    \"id_list\": \"TARGET_LIST_ID\",\n    \"pos\": \"top\"\n  }'\n```\n\n### Create a new board\n\n```bash\nclawlink_call_tool --tool \"trello_add_board\" \\\n  --params '{\n    \"name\": \"Project Alpha\",\n    \"desc\": \"Tracking deliverables for the alpha release\",\n    \"id_org\": \"ORGANIZATION_ID\",\n    \"visibility\": \"org\"\n  }'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Trello is connected.\n2. Call `clawlink_list_tools --integration trello` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `trello`.\n5. If no Trello tools appear, direct the user to https://claw-link.dev/dashboard?add=trello.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  READ OPERATIONS (Safe)                                     │\n│  list → get → describe → search                             │\n│                                                             │\n│  Example: List boards → Get board → Get card → Show details│\n└─────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────┐\n│  WRITE OPERATIONS (Require Confirmation)                    │\n│  describe → preview → confirm → call                        │\n│                                                             │\n│  Example: Preview card creation → User approves → Create   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, get, and search operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- Board, list, and card IDs are required for most operations — resolve them from board/card lookups first.\n- Card moves between boards require both `card_id` and `id_board` parameters.\n- Checklist items converted to cards cannot be customized during conversion — the card inherits basic properties.\n- Archived cards and boards can be restored via the Trello web UI but not via the API.\n- Webhooks require a publicly accessible callback URL — they will not work with localhost.\n- Label operations on cards require knowing the label ID, which comes from `trello_get_board_labels`.\n- Organization (workspace) membership determines which boards are accessible.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration trello`. |\n| Missing connection | Trello is not connected. Direct the user to https://claw-link.dev/dashboard?add=trello. |\n| `board_not_found` | The board ID does not exist or is not accessible. |\n| `list_not_found` | The list ID does not exist on the target board. |\n| `card_not_found` | The card ID does not exist or was archived. |\n| `member_not_found` | The member ID or username does not match any board member. |\n| `invalid_token` | The OAuth token is invalid or expired. Reconnect Trello. |\n| `webhook_not_found` | The webhook ID does not exist. |\n| `model_not_found` | The target resource (card, board, etc.) was not found. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n   ```bash\n   openclaw plugins list\n   ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n   ```bash\n   openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n   openclaw gateway restart\n   ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Card Operations Fail\n\n1. Verify the list ID exists on the target board — use `trello_get_lists` to confirm.\n2. Check that the card is not already archived — archived cards cannot be moved, only deleted.\n3. Confirm the board's permission settings allow the operation.\n\n## Resources\n\n- [Trello API Documentation](https://developer.atlassian.com/cloud/trello/)\n- [Trello REST API Reference](https://developer.atlassian.com/cloud/trello/rest/)\n- [Trello Power-Ups](https://trello.com/power-ups)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=trello-projects\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=trello-projects)** — an integration hub for OpenClaw\n\n![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)","tags":{"latest":"1.0.6"},"stats":{"comments":0,"downloads":1758,"installsAllTime":1,"installsCurrent":1,"stars":5,"versions":8},"createdAt":1778076057747,"updatedAt":1780989617528},"latestVersion":{"version":"1.0.6","createdAt":1780989617528,"changelog":"Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.","license":"MIT-0"},"metadata":null,"owner":{"handle":"hith3sh","userId":"s173vws87a7ss71xf9rq53k5gd8568kv","displayName":"Jay","image":"https://avatars.githubusercontent.com/u/83839061?v=4"},"moderation":null}