ClickUp MCP Server
Connect AI agents to your ClickUp tasks, lists, docs, and time tracking over the official MCP server.
Updated
What is ClickUp MCP?
The ClickUp MCP server is a Model Context Protocol server, hosted by ClickUp, that lets AI agents and assistants work with your ClickUp workspace — tasks, lists, folders, spaces, docs, chat, and time tracking — using natural language.
It is a first-party, remote service reachable at https://mcp.clickup.com/mcp. Because ClickUp hosts it, there is nothing to install or run yourself: you point an MCP-capable client at the URL and authenticate. Authentication is OAuth only — you cannot use a personal API key or auth token — so the agent acts within the permissions of the connected ClickUp user.
The server exposes much of ClickUp's API surface as MCP tools, and can chain several tools in a single call to complete multi-step actions (for example, finding a list, creating a task, and assigning it). It is available on all ClickUp plans and is currently in public beta.
Tools the ClickUp MCP server exposes
| Tool | What it does |
|---|---|
| Search Workspace | Locate tasks, lists, folders, and docs across the entire workspace. |
| Create Task | Create a new task in a specified list with custom details. |
| Get Task | Retrieve full details for a single task by ID. |
| Update Task | Modify task properties like status, assignees, or due dates. |
| Get Workspace Hierarchy | Return the full org structure of spaces, folders, and lists. |
| Create List | Create a new list in a folder or space. |
| Start Time Tracking | Start a timer on a task. |
| Add Time Entry | Manually log a block of time to a task. |
| Create Document | Create a new doc in the workspace. |
| Send Chat Message | Post a message to a ClickUp chat channel. |
Connect the ClickUp MCP server
Claude Code
- 1
Add the server
Run: claude mcp add --transport http clickup https://mcp.clickup.com/mcp
- 2
Start a session and authenticate
Open Claude Code and run /mcp to launch the ClickUp OAuth flow in your browser.
- 3
Authorize ClickUp
Approve access for your ClickUp account; the agent then acts within that user's permissions.
- 4
Use it
Ask Claude to search tasks, create or update them, log time, or write docs.
Claude Desktop instead uses an mcp-remote config: command npx, args ["-y","mcp-remote","https://mcp.clickup.com/mcp"].
Cursor
- 1
Edit mcp.json
Add a clickup server with url https://mcp.clickup.com/mcp under mcpServers.
- 2
Reload MCP servers
Cursor picks up the new server from Settings > MCP.
- 3
Authenticate
On first use, complete the ClickUp OAuth prompt in your browser.
- 4
Use it
Reference ClickUp tasks, lists, and docs directly from the Cursor agent.
Security & permissions
Authentication is OAuth only — personal API keys and auth tokens are not accepted. When you authorize the connection, the agent operates within the permissions of the signed-in ClickUp user, so it can read and modify only the tasks, lists, docs, and time entries that user can access. Scope access by connecting an account with the right workspace permissions. Calls are rate-limited per 24-hour rolling window depending on plan and the Everything AI add-on.
Using ClickUp MCP with Gamut
In Gamut, you connect ClickUp once and an agent can then use the MCP server as a tool inside automated, event- or schedule-triggered workflows — Gamut manages the OAuth connection so the agent calls ClickUp on demand. For example, a scheduled agent can search for overdue tasks and post a daily summary, or an event-triggered agent can create and assign a task when a request comes in elsewhere. The agent acts within the connected ClickUp user's permissions and ClickUp's MCP rate limits.
Frequently asked questions
What is the ClickUp MCP server?
It's ClickUp's official, hosted Model Context Protocol server at https://mcp.clickup.com/mcp that lets AI agents work with your ClickUp tasks, lists, folders, spaces, docs, chat, and time tracking using natural language.
Is the ClickUp MCP server free?
It's included on all ClickUp plans and is currently in public beta. Without the Everything AI add-on, calls are rate-limited (50 per 24 hours on Free Forever, 300 per 24 hours on Unlimited and above); with the add-on, standard Public API rate limits apply.
How do I connect the ClickUp MCP server to Claude or Cursor?
For Claude Code, run 'claude mcp add --transport http clickup https://mcp.clickup.com/mcp', then run /mcp to complete OAuth. For Cursor, add a clickup server with url https://mcp.clickup.com/mcp to mcp.json and approve the OAuth prompt on first use.
Is the ClickUp MCP server hosted or self-hosted?
It's hosted by ClickUp as a first-party remote service, so there's nothing to install or run — you point your MCP client at the URL and authenticate with OAuth. (Community-built self-hosted ClickUp MCP servers also exist, but this is ClickUp's official one.)