Trello Ops

Trello Skill

[!IMPORTANT] This skill MUST be executed strictly under the Omni-Architect Agent Protocol v1.0. All tool executions, code modifications, and communications MUST adhere to the 13 core protocols.

Manage Trello boards, lists, cards, labels, and members via REST API or MCP.

⚠️ Tool Availability (READ FIRST)

This skill supports multiple tool backends. Use whichever is available:

1. MCP Tools (mcp__trello) — Use if available in your tool set
2. Helper Script (trello-ops.sh) — Always available via Bash
3. Direct curl — Fallback for any operation

If MCP tools are NOT available, use the helper script:

# List boards
./scripts/trello-ops.sh get-boards

# Create a card
./scripts/trello-ops.sh create-card <listId> "Card title" "Description"

# Move a card
./scripts/trello-ops.sh move-card <cardId> <targetListId>

Do NOT report "MCP tools not available" as a blocker — use the script or curl.

🔐 Security: API Credentials

CRITICAL: Never expose API keys or tokens in terminal output or context.

Safe Commands (Always Use)

# Verify credentials are set (safe — only checks existence)
[ -n "$TRELLO_API_KEY" ] && echo "API Key: set" || echo "API Key: NOT SET"
[ -n "$TRELLO_TOKEN" ] && echo "Token: set" || echo "Token: NOT SET"

Unsafe Commands (NEVER Use)

# ❌ NEVER — exposes credentials
echo $TRELLO_API_KEY
echo $TRELLO_TOKEN
printenv | grep TRELLO

Setup

1. Get API Key from https://trello.com/power-ups/admin
2. Generate Token from the API Key page (authorize your app)
3. Add to environment:

# Add to ~/.zshrc
export TRELLO_API_KEY="your_api_key_here"
export TRELLO_TOKEN="your_token_here"

Quick Start

1. Verify Setup

# From the skill directory
bash scripts/trello-ops.sh get-boards

Expect: JSON array of your boards.

2. Common Operations

# List all boards
bash scripts/trello-ops.sh get-boards

# List lists on a board
bash scripts/trello-ops.sh get-lists <boardId>

# List cards on a list
bash scripts/trello-ops.sh get-cards <listId>

# Create a card
bash scripts/trello-ops.sh create-card <listId> "Title" "Description"

# Move a card to another list
bash scripts/trello-ops.sh move-card <cardId> <targetListId>

# Archive a card
bash scripts/trello-ops.sh archive-card <cardId>

# Add a comment
bash scripts/trello-ops.sh add-comment <cardId> "Comment text"

# Add a label
bash scripts/trello-ops.sh add-label <cardId> <color>

# Show help
bash scripts/trello-ops.sh help

Tool Selection

MCP Server Configuration

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@anthropic/trello-mcp-server"],
      "env": {
        "TRELLO_API_KEY": "${TRELLO_API_KEY}",
        "TRELLO_TOKEN": "${TRELLO_TOKEN}"
      }
    }
  }
}

NOTE: Multiple community MCP servers exist (Smithery, Composio). Use whichever is configured.

Trello Data Model

Workspace (Organization)
└── Board
    ├── Lists (columns)
    │   └── Cards (tasks)
    │       ├── Labels
    │       ├── Members
    │       ├── Checklists
    │       ├── Comments
    │       ├── Attachments
    │       └── Due dates
    └── Labels (board-scoped)

Key Concepts

• Board = Project or team workspace
• List = Column (e.g., "To Do", "In Progress", "Done")
• Card = Task or work item
• Label = Color-coded category tag

Conventions

Card Naming

Use conventional prefixes for clarity:

• [FEAT] — New feature
• [BUG] — Bug fix
• [REFACTOR] — Code refactoring
• [DOCS] — Documentation
• [CHORE] — Maintenance task

Standard Board Lists

Labels (Color Convention)

Advanced: Direct API Usage

For operations not covered by the helper script, see references/api-reference.md for:

• Full endpoint documentation
• Webhook configuration
• Batch operations
• Custom fields
• Power-Up integration

Base URL: https://api.trello.com/1/

Auth params: ?key=${TRELLO_API_KEY}&token=${TRELLO_TOKEN}

Reference

External: Trello REST API Docs