ClickUp MCP Server
Lets Claude, ChatGPT or Cursor find, create and update your ClickUp tasks, Docs, comments and time entries. ClickUp hosts it; you sign in with ClickUp.
This is ClickUp's official way to connect your AI assistant to ClickUp, and ClickUp runs it for you. You can ask it to search your workspace, create and update tasks, write Docs, post comments and chat messages, and log time. It acts with your own ClickUp permissions, can delete and merge tasks, and has no read-only mode. Every plan can use it, but each plan has a daily call limit.
Good for
- Teams who plan work in ClickUp and want their AI assistant to create and update tasks
- Managers who want status updates, release notes and reports pulled from tasks and Docs
- People who track time in ClickUp and want to start timers or log hours by asking
- Developers who want ClickUp tasks inside Claude Code, Cursor or VS Code
Works in
4 supported · 2 with issues · 8 should work
Tap an app to see how to set it up and any known problems.
ClickUp's docs cover it: add the URL with claude mcp add, then run /mcp to sign in. developer.clickup.com
ClickUp's docs cover it: install from Cursor's marketplace or add the URL to mcp.json. developer.clickup.com
ClickUp's docs cover it: add it with one code command, then start the server and sign in. developer.clickup.com
ClickUp's docs cover it: add a custom server in Cascade settings with the ClickUp URL. developer.clickup.com
ClickUp's docs cover it: add the URL as a connector on paid Claude plans, or through a config file on Free.
Known problems
- Open
Logging time with tags fails but still creates the entry, so retrying makes duplicates
Since Sep 2026 · feedback.clickup.com
ClickUp is a ChatGPT app: open Apps, search ClickUp, connect and pick your workspaces.
Known problems
- Open
Custom field values do not come through in ChatGPT
Since Aug 2026 · feedback.clickup.com
- Fixed
Connecting failed with an invalid client error before you could sign in
Reported Aug 2026 · feedback.clickup.com
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install ClickUp MCP
Claude Code
- 1
Copy this prompt.
Add the ClickUp MCP server to Claude Code. Run this command: claude mcp add --transport http clickup https://mcp.clickup.com/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires ClickUp account (any plan).
Read-only mode: There is no read-only mode. Turn on your app's setting that asks before each change, since it can delete and merge tasks.
Then start Claude Code and run /mcp to sign in to ClickUp. Calls count toward your plan's daily limit, from 100 a day on Free Forever.
From the vendor's docs. Source.
Tools
Searches your whole workspace for tasks, Docs, chats and more
Searches across your ClickUp workspace, including tasks, Docs, dashboards, attachments, whiteboards, chats and forms, by keyword and filters.
Try: “Find all tasks related to the Q4 Marketing Launch.”
Network ·
clickup_searchFinds tasks by list, status, assignee, tag or due date
Lists tasks that match the filters you give, such as a List, status, assignee, tag, date range or custom field, or the tasks in a saved view.
Try: “Show me the tasks with the UX-quality tag.”
Network ·
clickup_filter_tasksOpens one task with its full details
Reads one task's details, such as its description, status, assignees and dates, and can also list the statuses that task can move to.
Try: “What are the details for task Design-123?”
Network ·
clickup_get_taskCreates a task with assignees, priority and due date
Creates a new task in a List. You can set the status, priority, dates, assignees, watchers, tags and custom fields, and the people you add are notified.
Try: “Create a task to draft the blog post in the Content Pipeline List, assign it to me and make it due Friday.”
Write ·
clickup_create_taskChanges a task's name, status, assignees, dates or fields
Updates the fields you name on a task. Setting assignees replaces the whole list, and the people affected are notified.
Try: “Change the status of the Draft blog post task to In Progress.”
Write ·
clickup_update_taskMoves a task to a different List
Moves a task to another List. The task's current status has to exist in the new List.
Try: “Move the login bug task to the Sprint 4 List.”
Write ·
clickup_move_taskShows a task in a second List as well
Adds an existing task to another List so it appears in both. This needs the Tasks in Multiple Lists feature turned on.
Try: “Also show the launch checklist task in the Marketing List.”
Write ·
clickup_add_task_to_listTakes a task out of an extra List it was added to
Removes a task from a List it was added to as an extra. The task itself stays in its home List.
Try: “Remove the launch checklist task from the Marketing List.”
Write ·
clickup_remove_task_from_listMoves a task and its subtasks to Trash
Deletes a task by sending it and its subtasks to Trash. You need Delete permission on the task.
Try: “Delete the testing use only task.”
Delete ·
clickup_delete_taskMerges duplicate tasks into one, with no undo
Combines one or more tasks into a target task, moving over their assignees, comments, attachments, subtasks and tracked time. The merged-in tasks are used up and this cannot be undone.
Try: “Merge the duplicate Login bug tasks into the original one.”
Delete ·
clickup_merge_tasksMarks one task as waiting on or blocking another
Adds a dependency between two tasks, shown on both, so you can see which one is waiting on the other.
Try: “Make the deploy task wait on the QA sign-off task.”
Write ·
clickup_add_task_dependencyRemoves a waiting-on or blocking link between tasks
Removes a dependency you set up between two tasks.
Try: “Remove the dependency between deploy and QA sign-off.”
Write ·
clickup_remove_task_dependencyLinks two related tasks
Adds a plain link between two tasks so each shows the other.
Try: “Link the pricing page task to the billing bug task.”
Write ·
clickup_add_task_linkRemoves a link between two tasks
Removes the link between two tasks.
Try: “Unlink the pricing page task from the billing bug task.”
Write ·
clickup_remove_task_linkCreates a new tag for a Space
Creates a tag that every task in a Space can use. Nothing changes if the tag already exists.
Try: “Create a tag called urgent-fix in the Engineering Space.”
Write ·
clickup_create_space_tagAdds an existing tag to a task
Puts a tag that already exists in the Space onto a task.
Try: “Tag the checkout bug task with urgent-fix.”
Write ·
clickup_add_tag_to_taskRemoves a tag from a task
Takes a tag off a task. The tag stays available in the Space.
Try: “Remove the urgent-fix tag from the checkout bug task.”
Write ·
clickup_remove_tag_from_taskLists the custom fields on a List, Folder or Space
Shows the custom fields defined on a List, Folder, Space or the whole workspace, with their options.
Try: “What custom fields does the Bugs List have?”
Network ·
clickup_get_custom_fieldsStarts your timer on a task
Starts your time tracker on a task. It refuses if you already have a timer running.
Try: “Start my timer on the client onboarding task.”
Write ·
clickup_start_time_trackingStops your running timer and saves the time
Stops the timer you have running and saves it as a time entry.
Try: “Stop my timer.”
Write ·
clickup_stop_time_trackingLogs time you already spent on a task
Adds a time entry to a task for a start time and duration. Running it twice logs the time twice.
Try: “Log 2 hours on the website redesign task for yesterday afternoon.”
Write ·
clickup_add_time_entryShows the timer you have running now
Tells you whether you have a timer running and on which task.
Try: “Is my timer running?”
Network ·
clickup_get_current_time_entryLists logged time with totals
Lists time entries for a task, date range or person, with totals. You only see other people's time if you are allowed to.
Try: “How many hours has the team spent on clients this month?”
Network ·
clickup_get_time_entriesShows how long a task has sat in each status
Reports how long one task has spent in each status. This needs the Total time in Status feature turned on.
Try: “How long has feature 123 been in progress?”
Network ·
clickup_get_task_time_in_statusShows time in each status for up to 100 tasks
Reports how long each of up to 100 tasks spent in each status.
Try: “How long did these five tasks spend in QA review?”
Network ·
clickup_get_bulk_tasks_time_in_statusAttaches a file to a task for everyone on it to see
Adds a file to a task from file data or a link, up to 100 MB. Everyone on the task can see it.
Try: “Attach this PDF of the contract to the Acme onboarding task.”
Write ·
clickup_attach_task_fileGets an upload link for a large file to a task or chat
Prepares an upload link so a file of up to 1 GB can be added to a task or chat message.
Try: “Upload this video recording to the design review task.”
Write ·
clickup_request_attachment_uploadGets a download link for a task's attachment
Returns details and a short-lived download link for a file attached to a task.
Try: “Open the mockup attached to the homepage task.”
Network ·
clickup_download_task_attachmentReads the comments on a task
Lists the comments on a task, with how many replies each has.
Try: “Summarize the comments on the checkout bug task.”
Network ·
clickup_get_task_commentsReads the replies under a comment
Lists the replies in a comment thread.
Try: “What did people reply to Sam's comment on the launch task?”
Network ·
clickup_get_threaded_commentsPosts a comment as you on a task, List or view
Posts a comment under your name on a task, List or view, or replies to a comment. People you mention are notified.
Try: “Comment on the launch task that the copy is approved.”
Write ·
clickup_create_commentPosts a comment as you on a task
Posts a comment under your name on a task. It does the same as the general comment tool under an older name.
Try: “Add a comment to the login bug saying it is fixed in staging.”
Write ·
clickup_create_task_commentEdits, resolves or reassigns a comment
Replaces a comment's text, marks it resolved, or assigns it to someone.
Try: “Mark my last comment on the launch task as resolved.”
Write ·
clickup_update_commentDeletes a comment
Deletes a comment. It cannot be brought back through the assistant.
Try: “Delete my duplicate comment on the login bug.”
Delete ·
clickup_delete_commentCreates a new Doc
Creates a ClickUp Doc in a Space, Folder or your private Docs. Public here means visible to workspace members who can open the parent, not the internet.
Try: “Create a Doc named Project Kickoff Notes in the Project Phoenix Space.”
Write ·
clickup_create_documentLists the pages in a Doc
Shows the pages and structure of a Doc, like a table of contents.
Try: “What are the pages in the Employee Handbook Doc?”
Network ·
clickup_list_document_pagesReads the content of Doc pages
Reads the text of one or more pages in a Doc.
Try: “Show me the Onboarding page from the Team Wiki Doc.”
Network ·
clickup_get_document_pagesAdds a page to a Doc
Adds a new page or sub-page to an existing Doc with the content you give.
Try: “Add a page titled Security Protocols to the Company Policies Doc.”
Write ·
clickup_create_document_pageRewrites or adds to a Doc page
Edits a Doc page. By default it replaces the whole page, but it can also add text to the start or end instead.
Try: “On the Security Protocols page, add a section on password management.”
Write ·
clickup_update_document_pageLists files attached to a Doc page
Lists the files attached to a Doc page.
Try: “What files are attached to the Onboarding page?”
Network ·
clickup_list_document_page_attachmentsGets a download link for a Doc page's file
Returns a short-lived download link for a file attached to a Doc page.
Try: “Open the org chart attached to the Onboarding page.”
Network ·
clickup_download_document_page_attachmentLists your Chat channels
Lists the ClickUp Chat channels you can see.
Try: “Which Chat channels am I in?”
Network ·
clickup_get_chat_channelsReads messages in a Chat channel
Reads the messages in a ClickUp Chat channel.
Try: “Summarize today's messages in the #launch channel.”
Network ·
clickup_get_chat_channel_messagesReads the replies in a Chat thread
Reads the replies under one Chat message.
Try: “What did people say in the thread under the release announcement?”
Network ·
clickup_get_chat_message_repliesSends a Chat message or DM as you
Posts a message under your name to a channel, a direct message to up to 15 people, or a thread reply. Recipients are notified.
Try: “Post in #launch that the release is live.”
Write ·
clickup_send_chat_messageEdits a Chat message you sent
Replaces the text of a Chat message, or resolves or assigns it. Files left out of the new text are removed.
Try: “Fix the typo in my last message in #launch.”
Write ·
clickup_update_chat_messageAdds or removes your emoji reaction on a message
Adds or removes your own emoji reaction on a Chat message.
Try: “Give the launch announcement a party emoji.”
Write ·
clickup_react_to_chat_messageOpens a List with its statuses
Reads a List's details, including the statuses tasks in it can use.
Try: “What statuses does the Bugs List have?”
Network ·
clickup_get_listCreates a List in a Space
Creates a new List directly in a Space.
Try: “Create a List called Q1 Campaigns in the Marketing Space.”
Write ·
clickup_create_listCreates a List inside a Folder
Creates a new List inside a Folder.
Try: “Create a List called Sprint 5 in the Engineering Sprints Folder.”
Write ·
clickup_create_list_in_folderRenames a List or changes its description
Changes a List's name, description or status.
Try: “Rename the Sprint 5 List to Sprint 5 - Payments.”
Write ·
clickup_update_listOpens a Folder's details
Reads a Folder's details by ID or by name within a Space.
Try: “What Lists are in the Clients Folder?”
Network ·
clickup_get_folderCreates a Folder in a Space
Creates a new Folder in a Space.
Try: “Create a Folder called 2027 Planning in the Operations Space.”
Write ·
clickup_create_folderRenames a Folder or changes its statuses
Renames a Folder, or changes the statuses used by every List in it.
Try: “Rename the Clients Folder to Active Clients.”
Write ·
clickup_update_folderSets a personal reminder
Creates a reminder for you with a title and due time.
Try: “Remind me to send the report Friday at 9 AM.”
Write ·
clickup_create_reminderChanges or completes one of your reminders
Edits one of your reminders or marks it done.
Try: “Move my report reminder to Monday.”
Write ·
clickup_update_reminderFinds your reminders
Lists your reminders, with optional filters.
Try: “What reminders do I have this week?”
Network ·
clickup_search_remindersShows your Spaces, Folders and Lists
Lists the Spaces, Folders and Lists you can see, so you or the assistant can find where things live.
Try: “Show me how our workspace is organized.”
Network ·
clickup_get_workspace_hierarchyLists workspace members with their emails
Lists the members of your workspace, including their email addresses.
Try: “Who is in our ClickUp workspace?”
Network ·
clickup_get_workspace_membersRuns bulk task changes, archiving and other extra actions
Runs one of a set of extra actions as you, such as creating or updating many tasks at once, archiving tasks, or managing views, forms and statuses. If it times out, check before retrying because it may have worked.
Try: “Archive the three old campaign tasks.”
Write ·
clickup_execute_operatorUsed by the assistant behind the scenes
Looks up one member by name or email
Finds one workspace member by name or email address.
Try: “Find Priya in our workspace.”
Network ·
clickup_find_member_by_nameTurns names or 'me' into the people to assign
Converts names, emails or 'me' into the user IDs ClickUp needs when assigning tasks.
Try: “Assign this to me and Jordan.”
Network ·
clickup_resolve_assigneesChecks who you are signed in as and your time zone
Returns the signed-in user, their time zone and the current time, which helps with due dates.
Try: “Which ClickUp account am I using?”
Network ·
clickup_get_userLists the extra actions the server allows
Shows which extra actions the bulk tool can run and what each needs.
Try: “Can you archive tasks?”
Network ·
clickup_get_operatorsDescribes how ClickUp items relate to each other
Explains how ClickUp objects such as Spaces, Lists and tasks connect, so the assistant can plan a request.
Try: “(Used by your assistant to plan requests.)”
Network ·
clickup_get_schema
From the official docs
Pros and cons
Good
- Built and hosted by ClickUp, with nothing to install
- Works on every ClickUp plan, including Free Forever
- Sign in with ClickUp; no API key to create or leak
- Covers tasks, Docs, comments, Chat, time tracking and reminders
- Bulk create and update tasks in one request
- ChatGPT app and Cursor marketplace listing for one-click setup
Watch out
- Daily call limits by plan, and no way to see how many you have used
- No read-only mode
- Cannot edit or delete time entries
- Some fields are missing, like Sprint Points and synced blocks
- Cannot search apps connected to ClickUp
Permissions
high risk · 4 things to watch
High risk
It can change, delete and merge anything you can in ClickUp, and post comments and messages under your name. Turn on your AI app's setting that asks before each change, and read what it plans to send.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete and merge tasks
It can send tasks to Trash, delete comments and merge tasks with no undo. Approve each of these yourself. developer.clickup.com
It posts comments and messages as you
What it sends appears under your name and notifies people. Read the text before you approve. developer.clickup.com
Retrying a failed write can make duplicates
If creating a task, comment or time entry times out, check ClickUp before you retry, or you may get two. developer.clickup.com
It only sees what you can see
Every action uses your own ClickUp permissions. It can read your workspace members' email addresses. developer.clickup.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. ClickUp marks deletes, merges, posts and overwrites as sensitive. |
|---|---|
| Talks to | mcp.clickup.com |
| Sign-in and keys | OAuth tokens held by your AI app; revocable from ClickUp |
| Scopes |
|
Alternatives
Use ClickUp's hosted server unless you hit its daily call limits or need fields it lacks. The community servers run on your computer with an API key, and the most popular one is now a paid product.
| Server | Official | Runs | Sign-in | Price | Weekly downloads |
|---|---|---|---|---|---|
| ClickUp MCP ServerThis page | Official | Hosted | ClickUp account | Free | – |
| taazkareem ClickUp MCP | Community | Local | API key or account | Paid | 22K/wk |
| hauptsachenet clickup-mcp | Community | Local | API key | Free | 469/wk |
What people say
People like running ClickUp through their assistant and dislike the call limits and missing fields.
What people like
- People who live in ClickUp like doing their work through an assistant instead of the ClickUp interface
- Setup is a URL and a ClickUp sign-in, with no API key
Common complaints
- Daily call limits frustrate heavy users, though ClickUp says it has raised them
- Some fields are missing, such as Sprint Points, synced blocks and custom field values in ChatGPT
- You cannot edit or delete time entries, so mistakes need fixing by hand
- A tagging bug creates time entries even when the call reports an error
In their words
“I try to interface with ClickUp exclusively through the API/MCP whenever possible. LLMs have been a lifeline to having to use that UI.”joshstrangeVendorAug 2026
“These artificial rate limits are the dumbest thing I've seen.”Ryan O'LearyVendorSep 2026
“An error that looks like nothing happened is an error people retry.”Joe WarnerVendorOct 2026
“The MCP lacks ability to set Sprint Points. Can you add this please?”Andrew Pavlov
Questions
What is the ClickUp MCP server URL?
https://mcp.clickup.com/mcp.
Is ClickUp MCP free?
Yes. It works on every ClickUp plan, including Free Forever, and does not use AI credits. Each plan has a daily call limit.
What are the ClickUp MCP rate limits?
Without the Everything AI add-on, calls per rolling 24 hours are 100 on Free Forever, 300 on Core or Unlimited, 1,000 on Business, 2,500 on Business Plus, 5,000 on Enterprise and 25,000 on Enterprise Plus. With the add-on, the normal per-minute API limits apply instead. ClickUp's developer docs say each AI app gets its own allowance, while its help center says they share one.
What happens when I hit the limit?
Requests fail until 24 hours after your first call in that window. The limit cannot be reset, and you cannot currently see how many calls you have used.
Can I use a ClickUp API key instead of signing in?
No. ClickUp only supports signing in with your ClickUp account. Community servers accept API keys if you need that.
Can it delete my tasks?
Yes. It can move tasks and their subtasks to Trash, delete comments, and merge tasks, which cannot be undone. Turn on your AI app's setting that asks before changes.
Is it safe to connect ClickUp to my AI assistant?
It can only do what your own ClickUp account can do, but that includes deleting tasks and posting as you. Approve changes one by one and read messages before they go out.
Can it search apps connected to ClickUp?
No. Connected Search only works inside ClickUp itself.
How do I add ClickUp to Claude?
On a paid Claude plan, add the URL as a connector in Settings. On Claude Free, use the config-file option in the install box above.
Examples
Capture a bug as a task
Create a task for this bug we're working on.
SourceWeekly to-do check
Find all my incomplete tasks due this week.
SourceProject milestones
List all milestones in the Product Launch project.
SourceClient hours report
How many hours has the team spent on clients this month?
SourceBulk status change
Move all tasks in the 'Sprint 3' List with the 'Ready for Review' status to 'In Review'.
Source
Information
updated Nov 1, 2026
- Publisher
- Official
- Transport
- Streamable HTTP
- Auth
- OAuth
Other ClickUp MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 7Hide
- MCP Server Setup Instructions · developer.clickup.com
- ClickUp's MCP Server · developer.clickup.com
- Supported Tools · developer.clickup.com
- What is ClickUp MCP? · help.clickup.com
- ClickUp MCP Server (first-party and official) · feedback.clickup.com
- Sorry, I'm in a meeting · news.ycombinator.com
- ClickUp MCP Server Premium · github.com