ClickUp MCP server
157 operations0 webhooks
Work management platform. Manage workspaces, spaces, folders, lists, tasks, comments, goals, time entries, docs, chat, views, and custom fields.
Try ClickUp with your agent
Connect ClickUp, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in ClickUp on my account, then run one read-only example and show me the result.
ClickUp tools and triggers
Tools are what your agent can do in ClickUp through Corsair's MCP server. Triggers are the ClickUp events a routine can start from.
Chat
- Channels CreateWrite
Create a chat channel
chat.channelsCreate
- Channels Create DmWrite
Create a direct message channel
chat.channelsCreateDm
- Channels Create LocationWrite
Create a location chat channel
chat.channelsCreateLocation
- Channels DeleteDestructive
Delete a chat channel
chat.channelsDelete
- Channels FollowersRead-only
List followers of a chat channel
chat.channelsFollowers
- Channels GetRead-only
Get a single chat channel
chat.channelsGet
- Channels ListRead-only
List chat channels in a Workspace
chat.channelsList
- Channels MembersRead-only
List members of a chat channel
chat.channelsMembers
- Channels UpdateWrite
Update a chat channel
chat.channelsUpdate
- Messages CreateWrite
Send a chat message
chat.messagesCreate
- Messages DeleteDestructive
Delete a chat message
chat.messagesDelete
- Messages ListRead-only
List messages in a chat channel
chat.messagesList
- Messages UpdateWrite
Update a chat message
chat.messagesUpdate
- Reactions CreateWrite
React to a chat message
chat.reactionsCreate
- Reactions DeleteDestructive
Remove a reaction from a chat message
chat.reactionsDelete
- Reactions GetRead-only
List reactions on a chat message
chat.reactionsGet
- Replies CreateWrite
Reply to a chat message
chat.repliesCreate
- Replies GetRead-only
List replies to a chat message
chat.repliesGet
- SubtypesRead-only
List post subtype IDs for a Workspace
chat.subtypes
- Tagged UsersRead-only
List users tagged in a chat message
chat.taggedUsers
Tasks
- Attachments CreateWrite
Upload a file attachment to a Task
tasks.attachmentsCreate
- Bulk Time In StatusRead-only
Get time in status for multiple Tasks
tasks.bulkTimeInStatus
- CreateWrite
Create a new Task
tasks.create
- Create From TemplateWrite
Create a Task from a template
tasks.createFromTemplate
- DeleteDestructive
Delete a Task
tasks.delete
- Filtered TeamRead-only
List filtered Tasks across a Workspace
tasks.filteredTeam
- GetRead-only
Get a single Task
tasks.get
- ListRead-only
List Tasks in a List
tasks.list
- MembersRead-only
List members with explicit Task access
tasks.members
- Move To Home ListWrite
Move a Task to a new home List
tasks.moveToHomeList
- Tags AddWrite
Add a tag to a Task
tasks.tagsAdd
- Tags RemoveDestructive
Remove a tag from a Task
tasks.tagsRemove
- TemplatesRead-only
List Task templates in a Workspace
tasks.templates
- Time In StatusRead-only
Get time a Task spent in each status
tasks.timeInStatus
- Tracked Time CreateWrite
Record legacy tracked time for a Task
tasks.trackedTimeCreate
- Tracked Time DeleteDestructive
Delete a legacy time-tracked interval
tasks.trackedTimeDelete
- Tracked Time GetRead-only
Get legacy tracked time for a Task
tasks.trackedTimeGet
- Tracked Time UpdateWrite
Edit a legacy time-tracked interval
tasks.trackedTimeUpdate
- UpdateWrite
Update an existing Task
tasks.update
Lists
- Comments CreateWrite
Comment on a List
lists.commentsCreate
- Comments GetRead-only
Get comments on a List
lists.commentsGet
- CreateWrite
Create a List in a Folder
lists.create
- Create FolderlessWrite
Create a folderless List in a Space
lists.createFolderless
- Create From TemplateWrite
Create a List from a template
lists.createFromTemplate
- DeleteDestructive
Delete a List
lists.delete
- FolderlessRead-only
List folderless Lists in a Space
lists.folderless
- GetRead-only
Get a single List
lists.get
- ListRead-only
List Lists in a Folder
lists.list
- MembersRead-only
List members of a List
lists.members
- UpdateWrite
Update a List
lists.update
- Views CreateWrite
Create a view in a List
lists.viewsCreate
- Views GetRead-only
List views in a List
lists.viewsGet
Time Entries
- CreateWrite
Create a time entry
timeEntries.create
- DeleteDestructive
Delete a time entry
timeEntries.delete
- GetRead-only
Get a single time entry
timeEntries.get
- HistoryRead-only
Get time entry change history
timeEntries.history
- RangeRead-only
List time entries in a date range
timeEntries.range
- RunningRead-only
Get the running time entry
timeEntries.running
- StartWrite
Start a time entry timer
timeEntries.start
- StopWrite
Stop the running time entry
timeEntries.stop
- Tags AddWrite
Add tags to time entries
timeEntries.tagsAdd
- Tags Get AllRead-only
List all time entry tags in a Workspace
timeEntries.tagsGetAll
- Tags RemoveDestructive
Remove tags from time entries
timeEntries.tagsRemove
- Tags UpdateWrite
Rename a time entry tag
timeEntries.tagsUpdate
- UpdateWrite
Update a time entry
timeEntries.update
Spaces
- Available FieldsRead-only
List custom fields available in a Space
spaces.availableFields
- CreateWrite
Create a new Space
spaces.create
- DeleteDestructive
Delete a Space
spaces.delete
- GetRead-only
Get a single Space
spaces.get
- ListRead-only
List Spaces in a Workspace
spaces.list
- Tags CreateWrite
Create a tag in a Space
spaces.tagsCreate
- Tags DeleteDestructive
Delete a tag from a Space
spaces.tagsDelete
- Tags GetRead-only
List tags in a Space
spaces.tagsGet
- Tags UpdateWrite
Update a tag in a Space
spaces.tagsUpdate
- UpdateWrite
Update an existing Space
spaces.update
- Views CreateWrite
Create a view in a Space
spaces.viewsCreate
- Views GetRead-only
List views in a Space
spaces.viewsGet
Guests
- Add To FolderWrite
Share a Folder with a guest
guests.addToFolder
- Add To ListWrite
Share a List with a guest
guests.addToList
- Add To TaskWrite
Share a Task with a guest
guests.addToTask
- GetRead-only
Get a Workspace guest
guests.get
- InviteWrite
Invite a guest to a Workspace
guests.invite
- RemoveDestructive
Remove a guest from a Workspace
guests.remove
- Remove From FolderDestructive
Remove a guest from a Folder
guests.removeFromFolder
- Remove From ListDestructive
Remove a guest from a List
guests.removeFromList
- Remove From TaskDestructive
Remove a guest from a Task
guests.removeFromTask
- UpdateWrite
Update a Workspace guest
guests.update
Workspaces
- Authorized UserRead-only
Get the authorized ClickUp user
workspaces.authorizedUser
- Custom RolesRead-only
List Workspace custom roles
workspaces.customRoles
- Custom Task TypesRead-only
List Workspace custom task types
workspaces.customTaskTypes
- Everything Views CreateWrite
Create an Everything-level Workspace view
workspaces.everythingViewsCreate
- Everything Views GetRead-only
List Everything-level Workspace views
workspaces.everythingViewsGet
- GetRead-only
List Workspaces (Teams)
workspaces.get
- PlanRead-only
Get the Workspace subscription plan
workspaces.plan
- SeatsRead-only
Get Workspace seat utilization
workspaces.seats
- Shared HierarchyRead-only
Get hierarchy shared with the authorized user
workspaces.sharedHierarchy
- Team FieldsRead-only
List Workspace-level custom fields
workspaces.teamFields
Docs
- ContentRead-only
Get full Doc content
docs.content
- CreateWrite
Create a new Doc
docs.create
- Create PageWrite
Create a page in a Doc
docs.createPage
- Page ContentRead-only
Get a single Doc page
docs.pageContent
- Page ListingRead-only
Get the page listing structure of a Doc
docs.pageListing
- PagesRead-only
List pages in a Doc
docs.pages
- SearchRead-only
Search Docs in a Workspace
docs.search
- Update PageWrite
Update a Doc page
docs.updatePage
Goals
- CreateWrite
Create a new Goal
goals.create
- DeleteDestructive
Delete a Goal
goals.delete
- GetRead-only
Get a single Goal
goals.get
- Key Results CreateWrite
Create a key result for a Goal
goals.keyResultsCreate
- Key Results DeleteDestructive
Delete a key result
goals.keyResultsDelete
- Key Results UpdateWrite
Update a key result
goals.keyResultsUpdate
- ListRead-only
List Goals in a Workspace
goals.list
- UpdateWrite
Update a Goal
goals.update
Folders
- CreateWrite
Create a new Folder
folders.create
- DeleteDestructive
Delete a Folder
folders.delete
- GetRead-only
Get a single Folder
folders.get
- ListRead-only
List Folders in a Space
folders.list
- UpdateWrite
Rename a Folder
folders.update
- Views CreateWrite
Create a view in a Folder
folders.viewsCreate
- Views GetRead-only
List views in a Folder
folders.viewsGet
Checklists
- CreateWrite
Create a checklist in a Task
checklists.create
- DeleteDestructive
Delete a checklist
checklists.delete
- Items CreateWrite
Create a checklist item
checklists.itemsCreate
- Items DeleteDestructive
Delete a checklist item
checklists.itemsDelete
- Items UpdateWrite
Update a checklist item
checklists.itemsUpdate
- UpdateWrite
Update a checklist
checklists.update
Task Comments
- CreateWrite
Comment on a Task
taskComments.create
- DeleteDestructive
Delete a Task comment
taskComments.delete
- GetRead-only
Get comments on a Task
taskComments.get
- Threaded CreateWrite
Reply to a comment in a thread
taskComments.threadedCreate
- Threaded GetRead-only
Get threaded replies to a comment
taskComments.threadedGet
- UpdateWrite
Update a Task comment
taskComments.update
Views
- Chat Comments CreateWrite
Comment on a Chat view
views.chatCommentsCreate
- Chat Comments GetRead-only
Get comments on a Chat view
views.chatCommentsGet
- DeleteDestructive
Delete a View
views.delete
- GetRead-only
Get a single View
views.get
- TasksRead-only
List Tasks visible in a View
views.tasks
- UpdateWrite
Update a View
views.update
Custom Fields
- AccessibleRead-only
List accessible custom fields for a List
customFields.accessible
- Folder FieldsRead-only
List custom fields available in a Folder
customFields.folderFields
- Remove ValueDestructive
Remove a custom field value from a Task
customFields.removeValue
- Set ValueWrite
Set a custom field value on a Task
customFields.setValue
Teams
- CreateWrite
Create a user group
teams.create
- DeleteDestructive
Delete a user group
teams.delete
- ListRead-only
List user groups
teams.list
- UpdateWrite
Update a user group
teams.update
Users
- GetRead-only
Get a Workspace user
users.get
- InviteWrite
Invite a user to a Workspace
users.invite
- RemoveDestructive
Remove a user from a Workspace
users.remove
- UpdateWrite
Update a Workspace user
users.update
Dependencies
- AddWrite
Add a waiting-on/blocking dependency to a Task
dependencies.add
- DeleteDestructive
Remove a dependency from a Task
dependencies.delete
Task Links
- AddWrite
Link two Tasks
taskLinks.add
- DeleteDestructive
Delete a link between two Tasks
taskLinks.delete
Task Lists
- AddWrite
Add a Task to an additional List
taskLists.add
- RemoveDestructive
Remove a Task from an additional List
taskLists.remove
Workspace Acl
- UpdateWrite
Update privacy and access for a Workspace object
workspaceAcl.update
Connect ClickUp to Claude, ChatGPT or Cursor
- 1
Connect ClickUp in Corsair
Add your ClickUp API key once in Corsair. Corsair stores the credential encrypted and makes the ClickUp API calls for your agent, so it never goes into a prompt or a config file. Connect ClickUp
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs ClickUp. On a ChatGPT personal plan, connect ClickUp here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, ClickUp's read and write operations run right away and its 28 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/clickup, add the ClickUp plugin, and connect with an API key. Then call methods like corsair.clickup.api.chat.channelsCreate() from your app. Corsair keeps each tenant isolated.
Yes. ClickUp requires an API key from your ClickUp account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit ClickUp, GitHub, Notion, Stripe, and the rest. Trigger ClickUp from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for work management platform. Manage workspaces, spaces, folders, lists, tasks, comments, goals, time entries, docs, chat, views, and custom fields. Common builds include sync jobs, admin tooling, and agents that call ClickUp APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per ClickUp API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/clickup in the open repo. When ClickUp ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your ClickUp data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store ClickUp data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put ClickUp on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 28 destructive ClickUp operations. You can change a link's mode at hub.corsair.dev/me.