clickup-mcp

A thin Model Context Protocol (MCP) server that exposes the full ClickUp REST API v2 as MCP tools.

Connect any MCP-compatible client (Claude Desktop, Cursor, etc.) to manage your ClickUp workspaces through natural language.

Features

• Workspaces & Teams — list workspaces, get workspace members

• Spaces — CRUD operations on spaces

• Folders — CRUD operations on folders

• Lists — CRUD operations on lists, folderless lists

• Tasks — full task lifecycle: create, read, update, delete, move, duplicate

• Task Fields — custom fields, assignees, tags, checklists, attachments

• Members — workspace and list members

• Comments — task and list comments

• Goals & Key Results — create and track goals

• Views — workspace, space, folder, and list views

• Webhooks — create and manage webhooks

• Time Tracking — log and query time entries

Setup

1. Get a ClickUp API Token

Go to ClickUp → Settings → Apps and generate a personal API token.

2. Install

npm install -g clickup-mcp

3. Configure Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "clickup": {
      "command": "clickup-mcp",
      "env": {
        "CLICKUP_API_TOKEN": "your_token_here"
      }
    }
  }
}

4. Run directly

CLICKUP_API_TOKEN=your_token clickup-mcp

Environment Variables

Development

git clone https://github.com/MohanadAlrefaai/clickup-mcp.git
cd clickup-mcp
npm install
npm run dev

License

MIT