ClickUp MCP

Remote MCP server for the entire public ClickUp REST API (v2 and v3): 177 tools for tasks, docs, chat, time tracking, goals, views, webhooks, guests, ACLs, audit logs and more. Things the public API can't do (keyword search across everything, reminders, doc page attachments, attachment downloads) pass through to ClickUp's official MCP server.

https://clickupmcp.k22i.com/mcp

Option 1: sign in with ClickUp (recommended)

Add the URL with no token. Your client opens a browser window to sign in to ClickUp and pick a workspace. This unlocks every tool, including the ones served by ClickUp's official MCP.

Claude Code:

claude mcp add --transport http clickup https://clickupmcp.k22i.com/mcp

claude.ai and Claude Desktop: Settings → Connectors → Add custom connector, paste the URL.

Cursor, Windsurf and other JSON-config clients:

{
  "mcpServers": {
    "clickup": {
      "url": "https://clickupmcp.k22i.com/mcp"
    }
  }
}

Option 2: personal API token

For clients without OAuth support, or scripts. In ClickUp open Settings → Apps → API Token and copy the pk_ token. Every REST tool works this way; the official-MCP pass-through tools don't, because ClickUp's MCP server only accepts its own sign-in.

claude mcp add --transport http clickup https://clickupmcp.k22i.com/mcp \
  --header "Authorization: Bearer pk_YOUR_TOKEN"

{
  "mcpServers": {
    "clickup": {
      "url": "https://clickupmcp.k22i.com/mcp",
      "headers": {
        "Authorization": "Bearer pk_YOUR_TOKEN"
      }
    }
  }
}

Clients that can't send headers can use https://clickupmcp.k22i.com/mcp?token=pk_YOUR_TOKEN. That URL is a credential.

URL options

`?mode=compact`	Expose helpers, pass-through tools and search/describe/call tools instead of every REST operation. Use it for clients with tool limits, such as Cursor.
`?readonly=1`	Only expose tools that read.
`?toolsets=tasks,docs`	Only expose these REST groups: `access`, `attachments`, `audit_logs`, `chat`, `comments`, `custom_fields`, `docs`, `folders`, `goals`, `lists`, `spaces`, `tags`, `tasks`, `templates`, `time_tracking`, `users`, `views`, `webhooks`, `workspaces`.
`?workspace_id=123`	Default workspace for tools that need one (also the `X-ClickUp-Workspace-Id` header). Without it the server uses your only workspace.

Combine them: https://clickupmcp.k22i.com/mcp?toolsets=tasks,comments&readonly=1.

Protocol

Streamable HTTP, MCP revision 2026-07-28 (stateless, no sessions); 2025-era clients are served through a stateless fallback. OAuth 2.1 with dynamic client registration and client ID metadata documents. The server stores only encrypted OAuth grants. Tool catalog: /tools.json.