---
slug: "trello-cli"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/ZenoxZX/trello-cli@main/README.md"
repo: "https://github.com/ZenoxZX/trello-cli"
source_file: "README.md"
branch: "main"
---
# Trello CLI

A CLI tool that provides Trello integration with Claude Code. With this tool, you can manage your Trello boards, lists, and cards using natural language through Claude Code.

## What is it?

`trello-cli` is a command-line tool that communicates with the Trello API. Claude Code uses this tool to:

- List your boards
- View, create, and update your cards
- Move cards between lists
- Track your tasks

## Installation

### Quick Install (Recommended)

Install directly from GitHub using the install script. Requires [Homebrew](https://brew.sh).

```bash
# Clone and install
git clone https://github.com/ZenoxZX/trello-cli.git
cd trello-cli
./install.sh
```

The install script will:
- Install .NET SDK via Homebrew if needed
- Build and install trello-cli as a global tool
- Install Claude Code skills to `~/.claude/skills/`

### Manual Build from Source

If you prefer to install manually or don't use Homebrew:

```bash
# Clone the repository
git clone https://github.com/ZenoxZX/trello-cli.git
cd trello-cli

# Install as global tool (requires .NET SDK 10.0+)
dotnet pack src/TrelloCli.csproj -c Release
dotnet tool install --global --add-source src/nupkg TrelloCli

# Verify installation
trello-cli --help
```

### Uninstalling

```bash
# Using uninstall script
./uninstall.sh

# Or manually
dotnet tool uninstall --global TrelloCli
```

### Setting Up Trello API Credentials

1. Get your API key and token from https://trello.com/app-key
2. Click the "Token" link on that page to generate a token
3. Configure the CLI:

```bash
# Set your credentials
trello-cli --set-auth <api-key> <token>

# Verify authentication
trello-cli --check-auth
```

## Usage

Simply mention "Trello" when talking to Claude Code:

```
"Show my Trello tasks"
"Add a new card to Trello: Login page design"
"Move this card to Done on Trello"
"List my Trello boards"
```

## Documentation

| File | Description |
|------|-------------|
| [docs/instruction.md](https://github.com/ZenoxZX/trello-cli/blob/HEAD/docs/instruction.md) | Detailed command reference and usage examples for AI |
| [docs/system-prompt.md](https://github.com/ZenoxZX/trello-cli/blob/HEAD/docs/system-prompt.md) | System prompt for AI integration |
| [.claude/skills/trello-cli/SKILL.md](https://github.com/ZenoxZX/trello-cli/blob/HEAD/.claude/skills/trello-cli/SKILL.md) | Claude Code skill definition and quick reference |
| [.claude/skills/trello-cli/REFERENCE.md](https://github.com/ZenoxZX/trello-cli/blob/HEAD/.claude/skills/trello-cli/REFERENCE.md) | Complete documentation of all commands |

## Claude Code Skill System

This repo uses Claude Code's **skill** system. Skills are configuration files that give Claude Code specialized capabilities.

### What is a Skill?

A skill is a markdown file that defines how Claude Code should use specific tools or APIs. They are located in the `.claude/skills/` directory.

### Adding the Skill to Your Personal Directory

To use this skill everywhere on your system, copy it to your personal `.claude` directory:

```bash
# Copy the skill folder to your personal directory
cp -r .claude/skills/trello-cli ~/.claude/skills/
```

After this, Claude Code will automatically activate this skill whenever you mention "Trello" in any directory.

### Skill Structure

```
~/.claude/
└── skills/
    └── trello-cli/
        ├── SKILL.md       # Main skill definition (trigger rules, quick reference)
        └── REFERENCE.md   # Detailed command documentation
```

### SKILL.md Anatomy

```markdown
---
name: trello-cli
description: Trello board, list and card management via CLI...
---

# Skill Content
...
```

- **name**: Unique name of the skill
- **description**: Description that determines when it activates (contains trigger words)

## Command Summary

```bash
# Authentication
trello-cli --set-auth <api-key> <token>
trello-cli --clear-auth
trello-cli --check-auth

# Board operations
trello-cli --get-boards
trello-cli --get-board <board-id>

# List operations
trello-cli --get-lists <board-id>
trello-cli --create-list <board-id> "<name>"

# Card operations
trello-cli --get-cards <list-id>
trello-cli --get-all-cards <board-id>
trello-cli --get-card <card-id>
trello-cli --create-card <list-id> "<name>" [--desc "<desc>"] [--due "YYYY-MM-DD"] [--labels "<ids>"] [--members "<ids>"]
trello-cli --update-card <card-id> [--name "<name>"] [--desc "<desc>"] [--due "<date>"] [--labels "<ids>"] [--members "<ids>"]
trello-cli --move-card <card-id> <target-list-id>
trello-cli --archive-card <card-id>
trello-cli --unarchive-card <card-id>
trello-cli --delete-card <card-id>

# Label operations
trello-cli --get-labels <board-id>
trello-cli --create-label <board-id> "<name>" [--color <color>]
trello-cli --update-label <label-id> [--name "<name>"] [--color <color>]
trello-cli --delete-label <label-id>

# Comment operations
trello-cli --get-comments <card-id>
trello-cli --add-comment <card-id> "<text>"

# Attachment operations
trello-cli --list-attachments <card-id>
trello-cli --upload-attachment <card-id> <file-path> [--name "<name>"]
trello-cli --attach-url <card-id> <url> [--name "<name>"]
trello-cli --delete-attachment <card-id> <attachment-id>

# Note: Downloading attachments is not supported - Trello's download API
# requires browser authentication. Use --attach-url to link attachments.

# Checklist operations
trello-cli --get-checklists <card-id>
trello-cli --create-checklist <card-id> "<name>"
trello-cli --delete-checklist <checklist-id>
trello-cli --add-checklist-item <checklist-id> "<name>"
trello-cli --update-checklist-item <card-id> <item-id> <complete|incomplete>
trello-cli --delete-checklist-item <checklist-id> <item-id>
```

## Requirements

- .NET 10.0 or later
- Trello account with API access

## License

This project is licensed under the [MIT License](https://github.com/ZenoxZX/trello-cli/tree/HEAD/LICENSE).