mcp-server-trello - SKILL.md Agent Skill

name: mcp-server-trello description: Trello MCP Server skill for board discovery, card workflows, checklist management, comments, attachments, labels, members, board/workspace selection, and health monitoring through the bundled @delorenj/mcp-server-trello server.

Trello MCP Server Skill

Use this skill when an agent needs to inspect or manage Trello boards through the bundled MCP server. The skill carries its own server source in assets/source/ and installs it locally on first use.

Activation

Before using Trello tools, verify that the local server has been installed.

Check for a built server at: {XDG_DATA_HOME:-$HOME/.local/share}/mcp-server-trello-skill/server/build/index.js
If it is missing, run: bash {skill-root}/scripts/install.sh
Confirm the MCP client has TRELLO_API_KEY and TRELLO_TOKEN configured. Optional values are TRELLO_BOARD_ID, TRELLO_WORKSPACE_ID, https_proxy, and HTTPS_PROXY.

The install script builds from assets/source/ when Bun is available. If Bun is not available, it falls back to the published package install path and creates a local wrapper at the same build/index.js check path.

Reading Order

Load only the reference needed for the current Trello task.

Start with references/trello-mcp/README.md for routing.
Use references/trello-mcp/configuration.md for authentication, install, and client setup.
Use references/trello-mcp/api.md when you need tool names and parameters.
Use references/trello-mcp/patterns.md for common board, card, checklist, and attachment workflows.
Use references/trello-mcp/gotchas.md for date formats, IDs, rate limits, and recovery steps.

Tool Routing

Choose tools by workflow, not by guessing IDs.

Board discovery: list_boards, set_active_board, get_active_board_info, list_workspaces, set_active_workspace, list_boards_in_workspace.
Lists and cards: get_lists, get_cards_by_list_id, get_card, add_card_to_list, update_card_details, move_card, archive_card, copy_card, add_cards_to_list, get_my_cards, get_card_history.
Checklists: create_checklist, get_checklist_items, add_checklist_item, find_checklist_items_by_description, get_acceptance_criteria, get_checklist_by_name, update_checklist_item, delete_checklist_item, copy_checklist.
Comments: add_comment, update_comment, delete_comment, get_card_comments.
Attachments: attach_image_to_card, attach_file_to_card, attach_image_data_to_card, download_attachment.
Labels and members: get_board_labels, create_label, update_label, delete_label, get_board_members, assign_member_to_card, remove_member_from_card.
Health: get_health, get_health_detailed, get_health_metadata, get_health_performance, perform_system_repair.

Agent Rules

Always discover the board, list, card, checklist, label, or member ID through tools before writing changes.
Prefer set_active_board after board discovery when several operations target the same board.
Use start dates as YYYY-MM-DD. Use due dates as full ISO 8601 timestamps.
Treat Trello API writes as external side effects. Confirm destructive actions such as archive, delete, or repair unless the user already authorized them.
Respect Trello rate limits: 300 requests per 10 seconds per API key and 100 requests per 10 seconds per token. The server queues requests, but agents should still batch discovery and avoid polling loops.