# Trello MCP Server

An MCP (Model Context Protocol) server that connects Claude to Trello, giving you full board, list, and card management through natural conversation.

Companion project for [Build a Custom Connector for Claude Cowork with the MCP TypeScript SDK](https://rebeccamdeprey.com/blog/build-custom-connector-claude-cowork), a step-by-step guide to building reliable MCP tools, structuring the Trello API client, testing with the MCP Inspector, and connecting the server to Claude.

## Tools Included

| Tool | Description |
|------|-------------|
| `trello_list_boards` | List all your Trello boards |
| `trello_get_board` | Get board details with lists and labels |
| `trello_list_lists` | List all lists on a board |
| `trello_create_list` | Create a new list on a board |
| `trello_archive_list` | Archive or unarchive a list |
| `trello_list_cards` | List cards on a board or list |
| `trello_get_card` | Get detailed card info |
| `trello_create_card` | Create a new card |
| `trello_update_card` | Update, move, or archive a card |
| `trello_delete_card` | Permanently delete a card |
| `trello_search_cards` | Search cards across boards |
| `trello_list_members` | List board members |
| `trello_get_activity` | View recent board activity |
| `trello_add_comment` | Add a comment to a card |
| `trello_get_comments` | Get comments on a card |
| `trello_add_checklist` | Add a checklist with items to a card |
| `trello_create_label` | Create a new label on a board |

## Setup

### 1. Get Trello API Credentials

1. Go to https://trello.com/power-ups/admin and create a Power-Up (or use an existing one)
2. Navigate to the **API Key** tab and generate a new API key
3. Generate a token by visiting:
   ```
   https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&key=YOUR_API_KEY
   ```
4. Click **Allow** and copy the token

### 2. Install and Build

```bash
cd trello-mcp-server
npm install
npm run build
```

### 3. Configure in Claude

Add to your Claude desktop config (`~/.claude/claude_desktop_config.json`) or Cowork MCP settings:

```json
{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/path/to/trello-mcp-server/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}
```

## Usage Examples

Once configured, you can ask Claude things like:

- "Show me all my Trello boards"
- "List the cards in my Sprint board's To Do column"
- "Create a card called 'Fix login bug' in the Backlog list"
- "Move that card to the In Progress list"
- "Add a checklist with testing steps to that card"
- "What's been happening on the project board this week?"
- "Search for any cards about the API redesign"