# Trello MCP Server

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for the Trello REST API. Connects Claude Desktop to your Trello workspace, giving Claude tools to manage boards, lists, cards, labels, and checklists.

## Features

- **Boards** — list, get, and create boards
- **Lists** — list, create, and update lists
- **Cards** — list, get, create, update, and delete cards (including moving between lists and setting due dates)
- **Labels** — list, create, add to cards, and remove from cards
- **Checklists** — get, create, add items, and check/uncheck items

## Prerequisites

- [Node.js](https://nodejs.org/) v18 or higher
- A Trello account
- Claude Desktop

## Setup

### 1. Clone the repo

```bash
git clone https://github.com/ChrisLochhead/Trello-MCP-Server.git
cd Trello-MCP-Server
```

### 2. Install dependencies and build

```bash
npm install
npm run build
```

### 3. Get your Trello API credentials

1. Go to [https://trello.com/power-ups/admin](https://trello.com/power-ups/admin)
2. Create a new Power-Up (name it anything — e.g. "My MCP App")
3. Navigate to the **API Key** tab and click **Generate a new API Key** — copy the key
4. On the same page, click the **Token** link, authorize, and copy the token from the resulting page

### 4. Configure Claude Desktop

Open your Claude Desktop config file:

- **Windows**: `C:\Users\<YourUsername>\AppData\Local\Claude\claude_desktop_config.json`
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

Add the following inside the top-level JSON object (not inside `"preferences"`):

```json
"mcpServers": {
  "trello": {
    "command": "C:\\Program Files\\nodejs\\node.exe",
    "args": ["C:\\path\\to\\Trello-MCP-Server\\dist\\index.js"],
    "env": {
      "TRELLO_API_KEY": "your_api_key_here",
      "TRELLO_API_TOKEN": "your_token_here"
    }
  }
}
```

> **Note for Windows users:** use the full path to `node.exe` (find it by running `where node` in Command Prompt). Use double backslashes in the path.

### 5. Restart Claude Desktop

After saving the config, restart Claude Desktop. In a new conversation, you can test it by asking:

> "List my Trello boards"

## Available Tools

| Tool | Description |
|------|-------------|
| `trello_list_boards` | List all boards for the authenticated user |
| `trello_get_board` | Get a board's details and lists |
| `trello_create_board` | Create a new board |
| `trello_list_lists` | Get all lists on a board |
| `trello_create_list` | Create a new list on a board |
| `trello_update_list` | Rename, archive, or reposition a list |
| `trello_list_cards` | List cards on a board or list |
| `trello_get_card` | Get full card details |
| `trello_create_card` | Create a new card |
| `trello_update_card` | Update a card (name, description, due date, list, etc.) |
| `trello_delete_card` | Permanently delete a card |
| `trello_list_labels` | Get all labels on a board |
| `trello_create_label` | Create a new label |
| `trello_add_label_to_card` | Add a label to a card |
| `trello_remove_label_from_card` | Remove a label from a card |
| `trello_get_card_checklists` | Get all checklists on a card |
| `trello_create_checklist` | Add a checklist to a card |
| `trello_add_checklist_item` | Add an item to a checklist |
| `trello_update_checklist_item` | Check/uncheck or rename a checklist item |

## Development

```bash
npm run dev    # Run with auto-reload (tsx watch)
npm run build  # Compile TypeScript to dist/
npm run clean  # Remove dist/
```

## License

MIT