# trello-mcp

Local MCP server (stdio) that lets Claude Code manage Trello tickets — boards, lists, cards, comments, checklists, labels, members.

## Setup

### 1. Get API key + token

You already have an API key from the Trello power-up admin page. You also need a **Token** (not the OAuth secret).

Open this URL in a browser, replacing `<API_KEY>`:

```
https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=ClaudeMCP&key=<API_KEY>
```

Approve, copy the resulting token.

### 2. Configure `.env`

```bash
cp .env.example .env
$EDITOR .env   # paste TRELLO_API_KEY and TRELLO_TOKEN
```

`TRELLO_DEFAULT_BOARD` is optional — set it to a board ID and tools that take `board_id` will use it when you omit the argument. To find a board's ID, open the board in the browser and append `.json` to the URL, or call `list_boards` once after the server is running.

### 3. Install deps

```bash
uv sync
```

### 4. Register with Claude Code

```bash
claude mcp add trello --scope user -- \
  uv run --directory "$(pwd)" trello-mcp
```

Verify:

```bash
claude mcp list
```

Restart any open Claude Code session, then in Claude run `/mcp` — you should see `trello` connected with 16 tools.

## Tools

Read: `list_boards`, `list_lists`, `list_cards`, `get_card`, `list_labels`, `list_board_members`

Card CRUD: `create_card`, `update_card`, `move_card`, `archive_card`

Annotations: `add_comment`, `add_checklist`, `add_checklist_item`, `set_check_item`, `add_label`, `assign_member`

## Manual smoke test

```bash
uv run fastmcp dev src/trello_mcp/server.py
```

Opens the MCP Inspector — try `list_boards` first.