ClickUp
Unified project, docs, and goals.
Verdict
Common use cases
- Triage support tickets into ClickUp tasks
- Link blockers during daily standups
- Tag tasks for sprint retrospectives
- Track time entries from Slack threads
- Assign guest reviewers to design tasks
Integration
- Vendor
- ClickUp
- Category
- productivity
- Auth
- OAUTH2
- Tools
- 50
- Composio slug
clickup
Tools
- Add dependency
Adds a 'waiting on' or 'blocking' dependency to a task, requiring either `depends on` (task becomes waiting on) or `dependency of` (task becomes blocking), but not both; `team id` is required if `custom task ids` is true.
- Add guest to folder
Adds a guest to a folder with specified permissions; requires a clickup enterprise plan.
- Add guest to list
Shares a clickup list with an existing guest user, granting them specified permissions; requires the workspace to be on the clickup enterprise plan.
- Add guest to task
Assigns a guest to a task with specified permissions; requires clickup enterprise plan, and `team id` if `custom task ids` is true.
- Add tags from time entries
Associates a list of specified tags with one or more time entries within a given team (workspace).
- Add tag to task
Adds an existing tag to a specified task; team id is required if custom task ids is true.
- Add task link
Links two existing and accessible clickup tasks, identified by `task id` (source) and `links to` (target).
- Add task to list
Adds an existing task to an additional clickup list; the "tasks in multiple lists" clickapp must be enabled in the workspace for this.
- Change tag names from time entries
Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team id`.
- Create a task
Creates a new clickup task in a specific list, optionally as a subtask if a `parent` task id (which cannot be a subtask itself and must be in the same list) is provided.
- Create a time entry
Creates a new time entry for a specified team.
- Create chat view comment
Posts a new comment to a specified clickup chat view; the 'view id' must correspond to an existing and accessible chat view.
- Create checklist
Creates a new checklist with a specified name within an existing task, which can be identified by its standard id or a custom task id (if `custom task ids` is true, `team id` is also required).
- Create checklist item
Creates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user.
- Create folder
Creates a new clickup folder within the specified space, which must exist and be accessible.
- Create folderless list
Creates a new folderless list (a list not part of any folder) directly within a specified clickup space.
- Create folder view
Creates a new, highly customizable view within a specific clickup folder using its `folder id`.
- Create goal
Creates a new goal in a clickup team (workspace).
- Create key result
Creates a new key result (target) for a specified goal in clickup to define and track measurable objectives towards achieving that goal.
- Create list
Creates a new list in clickup within a specified, existing folder.
- Create list comment
Adds a new comment with specific text to an existing and accessible clickup list, assigns it to a user, and sets notification preferences for all list members.
- Create list view
Creates a new, customizable view (e.g., list, board, calendar) within a specified clickup list, requiring an existing list id accessible by the user.
- Create space
Creates a new space in a clickup team, with customizable name, privacy, color, and feature settings.
- Create space tag
Creates a new tag (name, foreground color, background color) in an existing clickup space.
- Create space view
Creates a customizable view (e.g., list, board, gantt) within a specified clickup space, allowing configuration of grouping, sorting, filtering, and display settings.
- Create task attachment
Uploads a file as an attachment to a specified clickup task, requiring `multipart/form-data` for file upload.
- Create task attachment
Deprecated: use `create task attachment` to upload a file to a task; requires `multipart/form-data`.
- Create task comment
Adds a comment to a clickup task; `team id` is required if `custom task ids` is true.
- Create task from template
Creates a new task in a specified clickup list from a task template, using the provided name for the new task.
- Create team
Creates a new team (user group) with specified members in a workspace; member ids must be for existing users, and be aware that adding view-only guests as paid members may incur extra charges.
- Create webhook
Creates a clickup webhook for a team (workspace) to notify a public url on specified events (at least one, or '*' for all), optionally scoped to a space, folder, list, or task; the endpoint must accept requests from dynamic ips.
- Create workspace Everything level view
Creates a new, customizable view (e.g., list, board) at the 'everything' level for a specified team (workspace id), encompassing all tasks within that workspace.
- Delete a time entrydestructive
Deletes an existing time entry, specified by `timer id`, from a workspace identified by `team id`.
- Delete checklistdestructive
Permanently deletes an existing checklist identified by its `checklist id`.
- Delete checklist itemdestructive
Permanently deletes an existing item, identified by `checklist item id`, from an existing checklist, identified by `checklist id`.
- Delete commentdestructive
Deletes an existing comment from a task using its `comment id`.
- Delete dependencydestructive
Removes two dependency links for `task id`: one where `task id` is blocked by `depends on`, and another where `dependency of` is blocked by `task id`; `team id` is required if `custom task ids` is true.
- Delete folderdestructive
Permanently and irreversibly deletes a specified folder and all its contents (lists, tasks) if the folder id exists.
- Delete goaldestructive
Permanently removes an existing goal, identified by its `goal id`, from the workspace.
- Delete key resultdestructive
Deletes an existing key result, also referred to as a target within a goal, identified by its `key result id`.
- Delete listdestructive
Permanently deletes an existing list and all its contents; this action is destructive and irreversible via the api.
- Delete spacedestructive
Permanently deletes a specified space in clickup; this action is irreversible as the space cannot be recovered via the api.
- Delete space tagdestructive
Deletes a tag from a space, identified by `tag name` in path; precise matching of tag details in the request body (`tag name 1`, `tag tag fg`, `tag tag bg`) is generally required for successful deletion.
- Delete taskdestructive
Permanently deletes a task, using its standard id or a custom task id (requires `custom task ids=true` and `team id`).
- Delete task linkdestructive
Deletes an existing link, effectively a dependency or relationship, between two clickup tasks; set `custom task ids=true` and provide `team id` if using custom task ids.
- Delete teamdestructive
Permanently deletes an existing team (user group) from the workspace using its `group id`.
- Delete time trackeddestructive
Deletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.
- Get access token
Deprecated: use `get access token` instead. exchanges a clickup oauth 2.0 authorization code for an access token.
- Get authorized teams workspaces
Deprecated: use `get authorized teams workspaces` instead to retrieve workspaces (teams) accessible to the authenticated user.
- Get authorized user
Deprecated: use `get authorized user` instead. retrieves details of the authenticated user's clickup account.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find ClickUp in the MCP directory and click Connect. 3. You'll redirect to ClickUp's OAuth consent screen — sign in with an account that has workspace admin permissions. 4. Grant Switchy access to tasks, lists, folders, time tracking, tags, and dependencies (the MCP requests read/write scopes for all resources it manages). 5. After authorizing, you'll return to Switchy with a confirmation that ClickUp is connected. 6. Open any Space, type '@ClickUp list my tasks' and send — if you see a response with your assigned tasks, the connection works. 7. To invoke a tool, @mention ClickUp followed by a natural-language instruction like 'add a blocker dependency from TASK-123 to TASK-456' or 'tag this task as urgent'.
What teammates see: by default, memories from ClickUp are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Create Task from Discussion
@ClickUp create a task in the Engineering list titled 'Fix login timeout bug' assigned to Sarah, due Friday, with description summarizing the thread above.Open in a Space →
Add Blocker Dependency
@ClickUp add a dependency so task TASK-789 is waiting on task TASK-456 to complete before it can start.Open in a Space →
Tag Tasks for Retro
@ClickUp add the 'Sprint-24' tag to tasks TASK-101, TASK-102, and TASK-103 so we can review them in Friday's retro.Open in a Space →
Log Time from Chat
@ClickUp log 2 hours to task TASK-555 with the note 'debugged API rate-limit issue' and tag it as backend work.Open in a Space →
Share Task with Guest
@ClickUp add guest user alex@contractor.com to task TASK-999 with comment and view permissions so they can review the design.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@ClickUp show me all high-priority tasks assigned to me across all my spaces that are due this week
Found 7 high-priority tasks due this week across 3 spaces: **Marketing Space** • "Q1 Campaign Review" - due Thursday, status: In Progress • "Blog post final edits" - due Friday, status: To Do **Product Space** • "User testing synthesis" - due Wednesday, status: In Review • "Feature spec approval" - due Thursday, blocked by 2 dependencies **Operations Space** • "Budget reconciliation" - due Tuesday, status: To Do • "Vendor contract review" - due Friday, overdue by 1 day • "Team offsite planning" - due Saturday, status: In Progress All tasks include links to open directly in ClickUp.
This example demonstrates cross-workspace search and filtering by assignee, priority, and due date. Requires OAuth scope covering all relevant spaces. Response time depends on the number of spaces in your workspace—accounts with 10+ spaces may see 2-3 second delays.
@ClickUp create a new task in our Sprint 12 list called "Implement rate limiting" with high priority, assign it to jordan@team.com, and tag it with backend and security
Created task "Implement rate limiting" in Sprint 12 list: • Task ID: #8472 • Priority: High • Assignee: Jordan Chen (jordan@team.com) • Tags: backend, security • Status: To Do (default) • Due date: None (not specified) Task created successfully and Jordan has been notified. You can view or edit the task at: https://app.clickup.com/t/8472 Note: The 'backend' and 'security' tags already existed in your workspace. If you need to create new tags, use the tag management tools first.
This write example shows task creation with multiple attributes in one prompt. Requires write permissions on the target list. The MCP will fail if the assignee email doesn't match an existing workspace member or if tags don't already exist—it won't auto-create them.
@ClickUp look at all tasks completed in the last sprint and draft a release note summarizing what shipped, grouped by feature area
Analyzed 23 completed tasks from Sprint 11 (closed 3 days ago). Here's a draft release note: **Release v2.8.0 - Sprint 11 Summary** *Authentication & Security (5 tasks)* Shipped OAuth2 refresh token rotation, added rate limiting to public API endpoints, and resolved 3 security audit findings. *User Interface (8 tasks)* Redesigned dashboard navigation, implemented dark mode toggle persistence, added keyboard shortcuts for common actions, and fixed 4 mobile responsiveness issues. *Performance (6 tasks)* Optimized database queries reducing page load by 40%, implemented Redis caching for user sessions, and upgraded CDN configuration. *Bug Fixes (4 tasks)* Resolved email notification delays, fixed CSV export formatting, corrected timezone handling in reports, and patched file upload error on Safari. All tasks marked 'Closed' between March 1-15.
This synthesis example pairs ClickUp's task data with AI reasoning to generate human-readable summaries. The grouping logic is inferred from task names and tags—accuracy improves if your team uses consistent naming conventions. Requires read access to the relevant space and list.
Use-case deep-dives
When ClickUp's dependency tools beat spreadsheets for multi-team sprints
A 12-person engineering org split across three squads hits a wall when Feature A blocks Feature B across teams. The PM opens Switchy, asks the agent to map all blocking dependencies between the mobile and backend lists, then bulk-add 'waiting on' links so standup doesn't devolve into Slack archaeology. ClickUp's dependency tooling shines here because the MCP exposes both directions (blocking vs waiting-on) and works across lists without manual clicking. The threshold: if your team is under 6 people working in a single list, dependencies are overkill—just @-mention in comments. But once you're juggling parallel workstreams and need a dependency graph that updates in real time, this MCP turns Switchy into a dependency-wiring command center. Worth it if you're already on ClickUp and dependencies are a daily friction point.
Guest permissions at Enterprise scale without the UI grind
A 5-person creative agency onboards a new client who needs read-only access to their project folder but shouldn't see internal retainer tasks. The account lead tells Switchy to add the client as a guest to the 'Brand Refresh' folder with view-only permissions, then repeat for two more stakeholders across three lists. ClickUp's guest tools (add-guest-to-folder, add-guest-to-list, add-guest-to-task) let the agent handle the permission matrix in one prompt instead of 15 UI clicks. The catch: this only works if you're on ClickUp Enterprise, and the MCP requires you to know folder/list IDs upfront—Switchy can fetch those, but it's a two-step dance. If you're on a lower tier or only share tasks occasionally, the native ClickUp UI is faster. If you onboard 3+ external collaborators per week, this MCP pays for itself in saved admin time.
Bulk tag operations when your timesheets live in ClickUp
A 4-person consulting team tracks billable hours in ClickUp but forgets to tag entries with client codes until invoicing week. The ops lead opens Switchy and says 'tag all time entries from last week that mention Acme Corp with #acme-q1'. The MCP's add-tags-from-time-entries tool hits the ClickUp API in bulk, avoiding the per-entry dropdown hunt. This scenario only makes sense if your team already uses ClickUp's native time tracking and you have a tagging taxonomy that maps to billing or reporting buckets. If you're under 10 hours per week or use Harvest/Toggl instead, the juice isn't worth the squeeze. But if you're reconciling 50+ entries monthly and tags drive your invoicing workflow, this MCP turns a 20-minute manual slog into a 30-second agent task.
Frequently asked
What can the ClickUp MCP do in Switchy?
It connects your ClickUp workspace so AI agents can create tasks, add dependencies, manage tags, link tasks, and share lists or folders with guests. With 50 tools available, agents can automate most ClickUp operations without opening the app. You authenticate once via OAuth2, and the MCP handles API calls in the background.
Do I need admin access to connect ClickUp?
You need workspace-level OAuth2 permissions to authorize the MCP. Some tools—like adding guests to folders, lists, or tasks—require a ClickUp Enterprise plan. If your workspace uses custom task IDs, you'll also need to pass the team ID parameter for certain operations. Standard ClickUp accounts can use most task-management tools.
Can the MCP add tasks to multiple lists at once?
Yes, but only if you've enabled the "Tasks in Multiple Lists" ClickApp in your workspace settings. The MCP's "Add task to list" tool will fail without that ClickApp turned on. This is a ClickUp platform limitation, not a Switchy restriction.
Why use this instead of ClickUp's native automations?
ClickUp automations are rule-based and run inside ClickUp. The MCP lets AI agents make decisions across your entire workspace—pulling data from Slack, updating tasks based on GitHub commits, or tagging time entries after analyzing meeting transcripts. You get cross-tool logic that ClickUp's built-in automations can't replicate.
Who on my team should connect the ClickUp MCP?
Whoever has workspace admin rights and understands your ClickUp structure—spaces, folders, custom fields. That person authorizes OAuth2 once, and all Switchy users inherit access to the 50 tools. If you're on Enterprise and want guest-management tools, the connector must have guest-invitation permissions in ClickUp.