UpsyGuidesSet up Upsy

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

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 and setup page 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):

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, 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):

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 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 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). 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 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, ChatGPT).
  • Grok and Muse: paste the setup prompt Upsy shows into a chat and approve the sign-in (Grok, Muse).

Server details, such as OAuth endpoints and token lifetimes, are in the Gmail MCP server guide; 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). 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.

Related guides