# ClickUp MCP server: setup, all 65 tools and daily limits

> ClickUp's official MCP server at mcp.clickup.com: setup in Claude, Claude Code, Cursor, ChatGPT and Codex, its 65 tools, daily call limits per plan, and fixes.

Updated 2026-11-15 · https://upsy.ai/guides/clickup-mcp-server

## Short answer

Yes, ClickUp has an official MCP server (a connector that lets an AI agent use your ClickUp) at `https://mcp.clickup.com/mcp`. Add it to Claude, Claude Code, Cursor, ChatGPT or any MCP client, sign in to ClickUp and pick your workspaces. The agent can then search, create and update tasks, comment, track time, write Docs and post in ClickUp Chat. In Claude Code:

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

Then run `/mcp` to sign in. It works on every ClickUp plan, but each workspace gets a daily number of MCP calls, from 100 on Free Forever, shared by every AI tool you connect. Add ClickUp through Upsy if an agent should only read, or never delete, or if you want ClickUp next to your email and calendar.

## ClickUp's MCP server

| | |
|---|---|
| Address | `https://mcp.clickup.com/mcp` (Streamable HTTP, no SSE) |
| Sign-in | OAuth 2.1 with dynamic client registration. Personal API tokens don't work |
| Reach | The workspaces you pick on ClickUp's consent screen, with your permissions |
| Plans | All, Free Forever included |
| Limits | A daily number of calls per workspace, shared by every MCP client |
| Admin | Inbound MCP follows the **Personal API Tokens** permission in custom roles |

ClickUp's [MCP overview](https://developer.clickup.com/docs/connect-an-ai-assistant-to-clickups-mcp-server) and [setup page](https://developer.clickup.com/docs/connect-an-ai-assistant-to-clickups-mcp-server-1) have the details.

### Daily call limits

ClickUp counts MCP calls over a rolling 24 hours, and "every MCP client connected to the same Workspace draws from the same pool of calls" ([ClickUp help](https://help.clickup.com/hc/en-us/articles/20686299081879)):

| Plan | MCP calls per 24 hours |
|---|---|
| Free Forever | 100 |
| Core, or Unlimited on older plans | 300 |
| Business | 1,000 |
| Business Plus | 2,500 |
| Enterprise | 25,000 on the new plans, 5,000 on older ones |
| Max | No daily limit |

On older plans, the Everything AI add-on lifts the daily cap and leaves only ClickUp's normal API limits. Over the limit, tools answer with `RATE_LIMIT_EXCEEDED` and a time to retry after.

### Connect it to your client

**Claude.** Add ClickUp from Claude's connector directory, where it's made by ClickUp, or add `https://mcp.clickup.com/mcp` as a custom connector.

**Claude Code.** Run the command above, or install ClickUp's plugin, which adds three skills: `claude plugin marketplace add clickup/clickup-plugin`, then `claude plugin install clickup@clickup-plugin-marketplace`.

**Cursor.** Install ClickUp from [Cursor's marketplace](https://cursor.com/marketplace/clickup), or add `{"mcpServers":{"clickup":{"url":"https://mcp.clickup.com/mcp"}}}` to `~/.cursor/mcp.json`.

**VS Code.** Run `code --add-mcp '{"type":"http","name":"clickup","url":"https://mcp.clickup.com/mcp"}'`.

**ChatGPT.** Open **Apps**, search for ClickUp and click **Connect**. On Team, Enterprise and Edu, only owners and admins can set it up.

**Codex.** Run `codex mcp add clickup --url https://mcp.clickup.com/mcp`, then `codex mcp login clickup`.

**Windsurf and Antigravity.** Add `"serverUrl": "https://mcp.clickup.com/mcp"`.

**Anything else.** Add a remote server with the address and OAuth, or run it through `npx -y mcp-remote https://mcp.clickup.com/mcp`.

### Its tools

ClickUp lists 65 tools, "the exact names your MCP client sees" ([tool list](https://developer.clickup.com/docs/mcp-tools)):

| Area | Read | Change |
|---|---|---|
| Tasks | `clickup_search`, `clickup_get_task`, `clickup_filter_tasks`, `clickup_get_custom_fields`, `clickup_get_schema`, `clickup_get_operators` | `clickup_create_task`, `clickup_update_task`, `clickup_move_task`, `clickup_merge_tasks`, `clickup_delete_task`, `clickup_add_task_to_list`, `clickup_remove_task_from_list`, `clickup_execute_operator` |
| Links, tags and files | `clickup_download_task_attachment` | `clickup_add_task_dependency`, `clickup_remove_task_dependency`, `clickup_add_task_link`, `clickup_remove_task_link`, `clickup_add_tag_to_task`, `clickup_remove_tag_from_task`, `clickup_create_space_tag`, `clickup_attach_task_file`, `clickup_request_attachment_upload` |
| Comments | `clickup_get_task_comments`, `clickup_get_threaded_comments` | `clickup_create_comment`, `clickup_create_task_comment`, `clickup_update_comment`, `clickup_delete_comment` |
| Time | `clickup_get_time_entries`, `clickup_get_current_time_entry`, `clickup_get_task_time_in_status`, `clickup_get_bulk_tasks_time_in_status` | `clickup_start_time_tracking`, `clickup_stop_time_tracking`, `clickup_add_time_entry` |
| Spaces, folders and lists | `clickup_get_workspace_hierarchy`, `clickup_get_list`, `clickup_get_folder` | `clickup_create_list`, `clickup_create_list_in_folder`, `clickup_update_list`, `clickup_create_folder`, `clickup_update_folder` |
| Docs | `clickup_list_document_pages`, `clickup_get_document_pages`, `clickup_list_document_page_attachments`, `clickup_download_document_page_attachment` | `clickup_create_document`, `clickup_create_document_page`, `clickup_update_document_page` |
| Chat | `clickup_get_chat_channels`, `clickup_get_chat_channel_messages`, `clickup_get_chat_message_replies` | `clickup_send_chat_message`, `clickup_update_chat_message`, `clickup_react_to_chat_message` |
| People and reminders | `clickup_get_workspace_members`, `clickup_find_member_by_name`, `clickup_resolve_assignees`, `clickup_get_user`, `clickup_search_reminders` | `clickup_create_reminder`, `clickup_update_reminder` |

- **Two tools delete.** `clickup_delete_task` sends a task and its subtasks to Trash. `clickup_delete_comment` "cannot be undone by the tool". `clickup_merge_tasks` can't be undone either. ClickUp's overview page still says it has no delete tools; its tool list says otherwise.
- **`clickup_execute_operator`** creates, updates or archives many tasks at once.
- **Older names:** Claude's directory lists 35 tools under earlier names, and `clickup_create_task_comment` is now the legacy name of `clickup_create_comment`.
- **It can't search apps connected to ClickUp,** such as a Google Drive linked to your workspace.

### Where ClickUp's server stops

- **The daily cap.** 100 calls a day on Free Forever goes fast, and every AI tool on the workspace shares it.
- **No read-only switch.** The connection can do whatever your ClickUp account can, deletes included. Narrower limits depend on your client's own settings.
- **Sign-ins don't renew.** ClickUp's server offers no refresh token, so when a sign-in ends, you sign in again.
- **No usage view.** ClickUp says monitoring MCP usage is "not at this time" possible.

For one workspace and a couple of AI tools, ClickUp's server is enough.

## ClickUp MCP servers compared

| | ClickUp's server | Upsy | taazkareem/clickup-mcp-server |
|---|---|---|---|
| Who runs it | ClickUp | Upsy, on top of ClickUp's server | You, or its paid hosted version |
| Sign-in | OAuth | OAuth to Upsy; Upsy signs in to ClickUp | An API key or OAuth |
| Price | Free, with daily caps | Free, with ClickUp's caps | $9 a month or $119 lifetime |
| Tools | 65 | ClickUp's 65, listed on request | About 150, it says |
| Limits | None of its own | Read-only or picked tools, per agent | Its own settings |
| Accounts | Workspaces picked at sign-in | Up to 5 ClickUp logins | One per key |

### Community servers

- **[taazkareem/clickup-mcp-server](https://github.com/taazkareem/clickup-mcp-server)** was the popular open-source server. It's now a paid "Premium" product with a proprietary license, adding goals, views, webhooks and audit logs.
- **[hauptsacheNet/clickup-mcp](https://github.com/hauptsacheNet/clickup-mcp)** is open source (MIT), works with an API key only, and has a minimal read mode for coding tools and CI.

People use them for API-key sign-in and extra tools. ClickUp says MCP limits and API limits are separate, so these may not count against the daily MCP cap.

### ClickUp as an MCP client

ClickUp Brain and Super Agents can use other MCP servers, on any plan ([ClickUp help](https://help.clickup.com/hc/en-us/articles/38503227973655)). Add one under **App Center › Custom MCP** in the browser. Admins can turn this off.

## Upsy's ClickUp MCP server

Upsy connects to ClickUp's server with your ClickUp sign-in, so the tools and daily limits are ClickUp's. It's the same address as Upsy's other apps, `https://upsy.ai/connect`.

What it adds:

- **Read-only.** Set an agent to **Read-only** and it can search and report on tasks without changing anything.
- **No deletes, no posting.** With **Pick actions**, leave out `clickup_delete_task`, `clickup_delete_comment` and `clickup_merge_tasks`, and every Comments and Chat change in the table above, such as `clickup_create_comment` and `clickup_send_chat_message`. Keep the rest.
- **ClickUp next to your other apps.** One server holds ClickUp, Gmail, Calendar, Slack and more, so an agent can turn an email into a task or log time from your calendar.
- **Up to five ClickUp logins,** each with its own access.
- **History and alerts:** every ClickUp tool an agent runs, listed under that agent.
- **Any client:** Claude, Claude Code, Cursor, Codex, ChatGPT, Grok, Muse, or anything with remote MCP and OAuth.

### Connect ClickUp to Upsy

1. Go to [upsy.ai](https://upsy.ai) and click **Set up Upsy**.
2. Open **Apps**, click **Connect an app** and pick **ClickUp**. Sign in and pick the workspaces on ClickUp's consent screen. For another login, click **Add account** next to ClickUp.
3. On the **Assistants** page, click **Add assistant** and choose your client under **Which assistant?** for its exact steps.

### Add the server to your client

Signing in opens an Upsy page: tick ClickUp, keep full access or pick **Read-only**, and click **Allow**. To leave out deletes, use **Pick actions** on the agent's page afterwards.

- **Claude Code:** `claude mcp add --transport http --scope user upsy https://upsy.ai/connect`, then `/mcp` to sign in.
- **Cursor:** add `{"mcpServers":{"upsy":{"url":"https://upsy.ai/connect"}}}` to `~/.cursor/mcp.json`, then click **Connect** next to upsy.
- **Codex:** `codex mcp add upsy --url https://upsy.ai/connect`, then `codex mcp login upsy`.
- **Claude and ChatGPT:** add `https://upsy.ai/connect` as a custom connector ([Claude](/guides/claude/custom-connector), [ChatGPT](/guides/chatgpt/custom-connector)).
- **Grok and Muse:** paste the setup prompt Upsy shows into a chat and approve the sign-in ([Grok](/guides/grok/clickup), [Muse](/guides/muse/clickup)).

Server details, such as OAuth endpoints and token lifetimes, are in the [Gmail MCP server guide](/guides/gmail-mcp-server#server-details); they're the same for ClickUp.

### Check that it works

> Using Upsy, list my ClickUp tasks due this week, with their status.

The agent should list tasks with their lists and statuses. The calls show in Upsy's **History** under that agent, and count toward ClickUp's daily cap.

## Prompts to try

- "Create a task in Marketing › Launch: write the release notes, due Friday, assigned to me."
- "What's still open in the current sprint, grouped by assignee?"
- "Start a timer on 'Draft newsletter', and stop it when I say I'm done."
- "Turn the action items in this email into subtasks of 'Website redesign'."
- "Summarize the comments on the pricing page task, then draft an update. Show me before posting."

## Troubleshooting

### `RATE_LIMIT_EXCEEDED`

The workspace used up its daily MCP calls, across every AI tool connected to it. Wait the time the error gives, ask for fewer, bigger requests, or move to a plan with a higher cap.

### `invalid_token`: "Bearer token required"

The sign-in is missing or has ended. Sign in again: `/mcp` in Claude Code, or reconnect in your client. In Upsy, click **Reconnect** next to ClickUp.

### "redirect_uri is not registered for this client"

The client's saved registration is stale. Remove ClickUp from the client and add it again.

### "Tool clickup_create_task_comment not found"

An older name that some clients still call ([Codex issue](https://github.com/openai/codex/issues/32710)). Ask the agent to use `clickup_create_comment`.

### Cursor: "Plugin "clickup" has unresolved or unsafe source path"

A bug in ClickUp's Cursor plugin. Add the server by hand to `~/.cursor/mcp.json` instead.

### The agent can't find a task or space

It sees only the workspaces you picked at sign-in and what your account can open. If you're in several workspaces, name the one you mean. To change workspaces, sign in again.

### "The user hasn't allowed you to use ClickUp's …"

That's Upsy refusing a tool outside the agent's level, such as `clickup_delete_task` when you left it out. Change ClickUp's level on the agent's page in Upsy.

## Security and privacy

- **Every connection acts as you,** in the workspaces you picked, and can delete tasks and comments and post in Chat. Keep your client's approval prompts on for changes.
- **Admins** control inbound MCP through the **Personal API Tokens** permission in custom roles, on plans that have them.
- **Prompt injection.** A task description or comment from someone else can carry instructions aimed at your agent. Give agents that read shared spaces Read-only.
- **Through Upsy,** agents never get your ClickUp token: they call Upsy, and Upsy calls ClickUp. Upsy emails you when one agent reads 100 or more items in 10 minutes or deletes 50 or more, and when a new agent or app connects.

## FAQ

### Is there an official ClickUp MCP server?

Yes. ClickUp hosts it at `https://mcp.clickup.com/mcp`, and Claude's directory lists it as made by ClickUp.

### Is the ClickUp MCP server free?

It's on every plan, but calls are capped per workspace per day: 100 on Free Forever, 300 on Core or Unlimited, and more on higher plans.

### Can I use a ClickUp API key with it?

No. ClickUp's server needs its OAuth sign-in. Community servers such as hauptsacheNet/clickup-mcp use an API key.

### Can the ClickUp MCP server delete tasks?

Yes: `clickup_delete_task` sends tasks to Trash, and `clickup_delete_comment` deletes comments for good. Through Upsy, leave both out with Pick actions.

### How many tools does the ClickUp MCP server have?

65 in ClickUp's list. Claude's directory shows 35 under older names.

### Does the daily limit apply per AI tool?

No. ClickUp says every MCP client connected to a workspace draws from the same daily pool.

---

Upsy connects personal AI assistants (Muse, Grok, ChatGPT, Claude, Cursor, Claude Code, Codex, Devin) to your Gmail, Google Calendar, Google Drive, Slack, Notion and other apps through one MCP server, with a shared memory, files and a cloud browser signed in to your sites. You choose what each assistant may do in each app, see everything it did, and turn it off in one click. Upsy is free. To add Upsy to an assistant, add a remote MCP server (Streamable HTTP) named Upsy at https://upsy.ai/connect. It signs in with OAuth; there is no API key.