# Trello Ops

> Trello Skill

- Skill: `luissambrano/trello-ops` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add luissambrano/trello-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luissambrano/trello-ops/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: LuisSambrano (https://skillmd.com/u/luissambrano)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/luissambrano/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:

```bash
# 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)

```bash
# 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)

```bash
# ❌ 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:

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

---

## Quick Start

### 1. Verify Setup

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

Expect: JSON array of your boards.

### 2. Common Operations

```bash
# 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

| Tool              | When to Use                            |
| ----------------- | -------------------------------------- |
| **MCP Server**    | Most operations — PREFERRED            |
| **Helper Script** | When MCP unavailable, quick operations |
| **Direct `curl`** | Custom or unsupported operations       |

### MCP Server Configuration

```json
{
  "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

| List        | Purpose                      |
| ----------- | ---------------------------- |
| Backlog     | Unscheduled work             |
| To Do       | Scheduled for current sprint |
| In Progress | Currently being worked on    |
| In Review   | Code review / QA             |
| Done        | Completed work               |

### Labels (Color Convention)

| Color    | Meaning            |
| -------- | ------------------ |
| `green`  | Low priority       |
| `yellow` | Medium priority    |
| `orange` | High priority      |
| `red`    | Critical / Blocker |
| `purple` | Enhancement        |
| `blue`   | Technical debt     |

---

## Advanced: Direct API Usage

For operations not covered by the helper script, see [references/api-reference.md](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

| Resource                                        | Purpose                          |
| ----------------------------------------------- | -------------------------------- |
| [api-reference.md](references/api-reference.md) | REST API endpoints and examples  |
| [scripts/trello-ops.sh](scripts/trello-ops.sh)  | CLI helper for common operations |

**External:** [Trello REST API Docs](https://developer.atlassian.com/cloud/trello/rest/)