@braid/mcp-clickup

A minimal MCP (Model Context Protocol) server for ClickUp integration.

Installation

Add to your Claude Code, Cursor, or other MCP-compatible tool:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "@braid/mcp-clickup@latest"],
      "env": {
        "CLICKUP_API_TOKEN": "pk_xxx",
        "CLICKUP_TEAM_ID": "your-team-id"
      }
    }
  }
}

Get your ClickUp API token from: ClickUp Settings > Apps > API Token

Available Tools

| Tool | Description | |------|-------------| | hierarchy | Get spaces, folders, lists, and team members | | search | Search tasks (with assignee/due date filters) | | task | Get task details by ID | | create | Create a task (with assignees, due date, tags) | | update | Update task (name, desc, status, priority, due date) | | delete | Delete a task | | assign | Add assignee to task | | unassign | Remove assignee from task | | tag | Add tag to task | | untag | Remove tag from task | | attach | Attach file (base64) to task |

Development

pnpm install
pnpm build
CLICKUP_API_TOKEN=pk_xxx pnpm start