MCPs Use Cases Use cases by category
Productivity & Inbox Inbox, calendar, and daily flow Engineering & DevOps Ship, debug, and run on-call Sales & CRM Pipeline, outreach, and deals Marketing & Growth Campaigns, SEO, and growth Support & Success Triage tickets, keep customers happy Finance & Ops Close, reconcile, and expenses Creative & Content Generate assets and content People & Hiring Hiring, onboarding, and HR Research & Data Synthesize data and insights See all use cases Blogs Pricing Docs Search | ⌘ KLogin Infrastructure You Can Trust for Agentic Products
© 2026 MewCP. All rights reserved.
ClickUp | MewCP
ClickUp
Share your feedback directly with the maintainers - every feedback helps make this server better for everyone.
Manage tasks, projects, and team workflows in ClickUp through the Model Context Protocol.
A Model Context Protocol (MCP) server that exposes ClickUp's API for managing workspaces, tasks, time tracking, and team collaboration.
Overview
The CL ClickUp MCP Server provides stateless, multi-user access to the ClickUp API with server-side credential injection:
Full workspace hierarchy management — spaces, folders, lists, and tasks
Time tracking, goals, checklists, custom fields, tags, and views
Team collaboration tools — comments, members, webhooks, docs, and chat
Perfect for:
Automating task creation, updates, and assignment from AI workflows
Querying and reporting across projects, sprints, and workspaces
Integrating ClickUp data into custom pipelines and productivity tools
Utility
ping → Health check for the MCP serverVerifies the server is running and reachable. No credentials required.
Inputs:
No inputs required.
Output:
{ "status" : "ok" , "server" : "CL ClickUp MCP Server" , "message" : "Server is running successfully!" , "api_base" : "https://api.clickup.com/api/v2" } usage Example:
Authorization
get_authorized_user → Get the authenticated user's profileReturns the ClickUp user associated with the injected OAuth access token.
Inputs:
No inputs required.
Output:
{ "user" : { "id" : 1234567 , "username" : "jane_doe" , "email" : "jane@example.com" , "color" : "#7B68EE" , "profilePicture" : "https://..." } } usage Example:
get_authorized_teams → List all accessible WorkspacesReturns all ClickUp Workspaces (teams) the authenticated user has access to.
Inputs:
No inputs required.
Output:
{ "teams" : [ { "id" : "9876543" , "name" : "My Workspace" , "color" : "#536DFE" , "members" : [{ "user" : { "id" : 1234567 , "username" : "jane_doe" } }] } Spaces
get_spaces → List all Spaces in a WorkspaceReturns all Spaces within the specified Workspace, with optional filtering for archived spaces.
Inputs:
team_id archived false Output:
{ "spaces" : [ { "id" : "90110011" , "name" : "Engineering" , "archived" : false , get_space → Get a specific SpaceReturns full details for a single Space by its ID.
Inputs:
space_id Output:
{ "id" : "90110011" , "name" : "Engineering" , "archived" : false , "multiple_assignees" : true , "features" : { "due_dates" : { "enabled" : true }, "time_tracking" : { create_space → Create a new Space in a WorkspaceCreates a Space with the specified name and feature configuration inside a Workspace.
Inputs:
team_id body Body fields:
name multiple_assignees features due_dates time_tracking Output:
update_space → Update an existing SpaceUpdates the name, settings, or feature flags of an existing Space.
Inputs:
space_id body Body fields:
name multiple_assignees features Output:
delete_space → Delete a SpacePermanently deletes a Space and all its contents.
Inputs:
space_id Output:
usage Example:
POST /mcp/clickup/delete_space
{ "space_id" : "90110011" } Folders
get_folders → List all Folders in a SpaceReturns all Folders within the specified Space.
Inputs:
space_id archived false Output:
{ "folders" : [ { "id" : "78901234" , "name" : "Sprint 1" , "task_count" : "12" , "lists" : [] } ] get_folder → Get a specific FolderReturns full details for a single Folder by its ID.
Inputs:
folder_id Output:
{ "id" : "78901234" , "name" : "Sprint 1" , "task_count" : "12" , "lists" : [{ "id" : "56789012" , "name" : "Backlog" }] } create_folder → Create a new Folder in a SpaceCreates a named Folder inside the specified Space.
Inputs:
space_id body Body fields:
name Output:
{ "id" : "78901299" , "name" : "Sprint 2" , "task_count" : "0" } update_folder → Update an existing FolderRenames or modifies an existing Folder.
Inputs:
folder_id body Body fields:
name Output:
{ "id" : "78901234" , "name" : "Sprint 1 (Completed)" } usage Example:
delete_folder → Delete a FolderPermanently deletes a Folder and all its lists.
Inputs:
folder_id Output:
usage Example:
POST /mcp/clickup/delete_folder
{ "folder_id" : "78901234" } Lists
get_lists → List all Lists in a FolderReturns all Lists within the specified Folder.
Inputs:
folder_id archived false Output:
{ "lists" : [ { "id" : "56789012" , "name" : "Backlog" , "task_count" : 8 , "status" : null get_folderless_lists → List all Lists not in a FolderReturns Lists that belong directly to a Space (not inside any Folder).
Inputs:
space_id archived false Output:
{ "lists" : [ { "id" : "56789099" , "name" : "Inbox" , "task_count" : 3 } ] } get_list → Get a specific ListReturns full details for a single List by its ID.
Inputs:
list_id Output:
{ "id" : "56789012" , "name" : "Backlog" , "task_count" : 8 , "due_date" : null , "priority" : null } usage Example:
create_list → Create a new List in a FolderCreates a named List inside the specified Folder.
Inputs:
folder_id body Body fields:
name content due_date priority assignee status
create_folderless_list → Create a List directly in a SpaceCreates a List at the Space level, not inside any Folder.
Inputs:
space_id body create_list Output:
{ "id" : "56789100" , "name" : "General" } usage Example:
update_list → Update an existing ListUpdates the name, description, due date, or other properties of a List.
Inputs:
list_id body Body fields:
name content due_date priority assignee unset_status delete_list → Delete a ListPermanently deletes a List and all its tasks.
Inputs:
list_id Output:
usage Example:
POST /mcp/clickup/delete_list
{ "list_id" : "56789012" } Tasks
get_tasks → List tasks in a ListReturns tasks in the specified List with optional pagination and filtering.
Inputs:
list_id archived false include_closed false page 0 order_by id get_task → Get a specific taskReturns full details for a single task by its ID.
Inputs:
task_id include_subtasks false include_markdown_description false Output:
{ "id" : "abc123" , "name" : "Fix login bug" , "description" create_task → Create a new task in a ListCreates a task with the specified properties inside a List.
Inputs:
list_id body Body fields:
name description markdown_description assignees tags status update_task → Update an existing taskUpdates any combination of task fields including name, status, priority, assignees, and due date.
Inputs:
task_id body Body fields:
name description status priority null due_date delete_task → Delete a taskPermanently deletes a task.
Inputs:
task_id Output:
usage Example:
POST /mcp/clickup/delete_task
{ "task_id" : "abc123" } get_filtered_team_tasks → List tasks across a Workspace with filtersReturns tasks across an entire Workspace with optional filtering by space, folder, list, status, assignee, and date ranges.
Inputs:
team_id page 0 order_by id created updated due_date reverse get_task_comments → List comments on a taskReturns all comments on the specified task, with optional pagination by date or comment ID.
Inputs:
task_id start start_id Output:
{ "comments" : [ { "id" : "55001122" , "comment_text" : "Looks good, merging tomorrow." , "user" : { "id" create_task_comment → Post a comment on a taskAdds a new comment to the specified task.
Inputs:
task_id body Body fields:
comment_text assignee notify_all false Output:
get_list_comments → List comments on a ListReturns all comments posted on the specified List.
Inputs:
list_id start start_id Output:
{ "comments" : [ { "id" : "55001123" , "comment_text" : "This list needs triage." , "user" : { "id" : create_list_comment → Post a comment on a ListAdds a new comment to the specified List.
Inputs:
list_id body Body fields:
comment_text notify_all false Output:
{ "id" : "55001200" , "comment" : [{ update_comment → Update an existing commentEdits the text or resolved state of a comment.
Inputs:
comment_id body Body fields:
comment_text assignee resolved Output:
delete_comment → Delete a commentPermanently deletes a comment.
Inputs:
comment_id Output:
usage Example:
POST /mcp/clickup/delete_comment
{ "comment_id" : "55001122" } Time Tracking
get_time_entries → List time entries in a WorkspaceReturns time entries within an optional date range, filterable by assignee.
Inputs:
team_id start_date end_date assignee include_task_tags false include_location_names false Output:
get_single_time_entry → Get a specific time entryReturns full details for a single time entry.
Inputs:
team_id timer_id Output:
{ "data" : { "id" : "1234567890" , "task" : { "id" : "abc123" }, "duration" : "3600000" , "start" : "1717100000000" , create_time_entry → Create a manual time entryLogs time against a task with explicit start time and duration.
Inputs:
team_id body Body fields:
start duration tid description billable Output:
update_time_entry → Update a time entryModifies the start time, duration, task, or description of an existing time entry.
Inputs:
team_id timer_id body Body fields:
start duration description tid billable delete_time_entry → Delete a time entryPermanently deletes a time entry.
Inputs:
team_id timer_id Output:
usage Example:
POST /mcp/clickup/delete_time_entry
{ "team_id" : "9876543" , start_time_entry → Start a running timerStarts a live timer optionally linked to a task.
Inputs:
team_id body Body fields:
tid description billable Output:
stop_time_entry → Stop the running timerStops the currently running timer for the authenticated user.
Inputs:
team_id Output:
{ "data" : { "id" : "9876543211" , "start" : "1717200000000" , "end" : "1717203600000" , "duration" : "3600000" } } usage Example:
get_running_time_entry → Get the currently running timerReturns the active timer for the authenticated user, if one is running.
Inputs:
team_id Output:
{ "data" : { "id" : "9876543211" , "start" : "1717200000000" , "task" : { "id" : "abc123" , "name" : "Fix login bug" } } } Members
get_workspace_members → List all members in a WorkspaceReturns the Workspace details including all member profiles.
Inputs:
team_id Output:
{ "team" : { "id" : "9876543" , "name" : "My Workspace" , "members" : [ { "user" : { "id" : 1234567 , "username" : "jane_doe" , "email" : get_task_members → List members assigned to a taskReturns all users who are assignees or watchers of the specified task.
Inputs:
task_id Output:
{ "members" : [ { "id" : 1234567 , "username" : "jane_doe" , "email" : "jane@example.com" } ] } usage Example:
get_list_members → List members with access to a ListReturns all users who have access to the specified List.
Inputs:
list_id Output:
{ "members" : [ { "id" : 1234567 , "username" : "jane_doe" , "email" : "jane@example.com" } ] } usage Example:
get_space_tags → List all tags in a SpaceReturns all tags defined within the specified Space.
Inputs:
space_id Output:
{ "tags" : [ { "name" : "bug" , "tag_fg" : "#FFFFFF" , "tag_bg" : "#FF0000" }, { "name" : "feature" , "tag_fg" : "#FFFFFF" , "tag_bg" : create_space_tag → Create a tag in a SpaceCreates a new named tag with custom foreground and background colors.
Inputs:
space_id body Body fields:
tag.name tag.tag_fg #FFFFFF tag.tag_bg #FF 0000 Output:
update_space_tag → Update a tag in a SpaceUpdates the name or colors of an existing tag.
Inputs:
space_id tag_name body Body fields:
tag.name tag.tag_fg tag.tag_bg Output:
delete_space_tag → Delete a tag from a SpaceRemoves a tag from the Space and detaches it from all tasks.
Inputs:
space_id tag_name Output:
usage Example:
POST /mcp/clickup/delete_space_tag
{ "space_id" : "90110011" add_tag_to_task → Apply a tag to a taskAttaches an existing Space tag to the specified task.
Inputs:
task_id tag_name Output:
usage Example:
POST /mcp/clickup/add_tag_to_task
{ "task_id" : "abc123" , remove_tag_from_task → Remove a tag from a taskDetaches a tag from the specified task.
Inputs:
task_id tag_name Output:
usage Example:
POST /mcp/clickup/remove_tag_from_task
{ "task_id" : "abc123" , Goals
get_goals → List all goals in a WorkspaceReturns all goals in the Workspace, optionally including completed ones.
Inputs:
team_id include_completed false Output:
{ "goals" : [ { "id" : "goal001" , "name" : "Q2 OKRs" , "due_date" : "1719792000000" , get_goal → Get a specific goalReturns full details for a single goal including key results.
Inputs:
goal_id Output:
{ "goal" : { "id" : "goal001" , "name" : "Q2 OKRs" , "percent_completed" : 45 , "key_results" : [], "owners" : [{ "id" : 1234567 }] } } create_goal → Create a new goalCreates a goal with a name, due date, owners, and optional color.
Inputs:
team_id body Body fields:
name due_date description multiple_owners owners color update_goal → Update a goalUpdates the name, description, due date, or owners of a goal.
Inputs:
goal_id body Body fields:
name due_date description rem_owners add_owners color delete_goal → Delete a goalPermanently deletes a goal.
Inputs:
goal_id Output:
usage Example:
POST /mcp/clickup/delete_goal
{ "goal_id" : "goal001" } Checklists
create_checklist → Create a checklist on a taskAdds a named checklist to the specified task.
Inputs:
task_id body Body fields:
name Output:
{ "checklist" : { "id" : "chk001" , "name" : "Pre-launch QA" , "task_id" : "abc123" update_checklist → Update a checklistRenames a checklist or changes its position.
Inputs:
checklist_id body Body fields:
name position Output:
{ "checklist" : { "id" : "chk001" , "name" : "Pre-launch QA (Final)" delete_checklist → Delete a checklistPermanently deletes a checklist and all its items.
Inputs:
checklist_id Output:
usage Example:
POST /mcp/clickup/delete_checklist
{ "checklist_id" : "chk001" } create_checklist_item → Add an item to a checklistAdds a new item to the specified checklist with optional assignee.
Inputs:
checklist_id body Body fields:
name assignee Output:
{ "checklist" : { "id" : "chk001" , "items" : [ update_checklist_item → Update a checklist itemEdits the text, assignee, or resolved state of a checklist item.
Inputs:
checklist_id checklist_item_id body Body fields:
name assignee resolved parent Output:
delete_checklist_item → Delete a checklist itemPermanently removes an item from a checklist.
Inputs:
checklist_id checklist_item_id Output:
usage Example:
POST /mcp/clickup/delete_checklist_item
{ "checklist_id" : "chk001" Custom Fields
get_accessible_custom_fields → List custom fields for a ListReturns all custom fields accessible within the specified List.
Inputs:
list_id Output:
{ "fields" : [ { "id" : "field001" , "name" : "Story Points" , "type" : "number" , "type_config" : { "precision" : 0 }, "required" : false set_custom_field_value → Set a custom field value on a taskAssigns a value to a specific custom field on a task. The value format depends on the field type.
Inputs:
task_id field_id body Body fields:
value Output:
remove_custom_field_value → Clear a custom field value from a taskRemoves the value of a custom field from a task, resetting it to empty.
Inputs:
task_id field_id Output:
usage Example:
POST /mcp/clickup/remove_custom_field_value
{ "task_id" : Views
get_team_views → List views at the Workspace levelReturns all views defined at the top level of a Workspace.
Inputs:
team_id Output:
{ "views" : [ { "id" : "view001" , "name" : "All Tasks" , "type" : "list" }, { "id" : "view002" , "name" : "Gantt" , "type" : get_space_views → List views in a SpaceReturns all views defined within the specified Space.
Inputs:
space_id Output:
{ "views" : [ { "id" : "view003" , "name" : "Sprint Board" , "type" : "board" } ] } usage Example:
get_folder_views → List views in a FolderReturns all views defined within the specified Folder.
Inputs:
folder_id Output:
{ "views" : [ { "id" : "view004" , "name" : "Sprint Timeline" , "type" : "gantt" } ] } usage Example:
get_list_views → List views in a ListReturns all views defined within the specified List.
Inputs:
list_id Output:
{ "views" : [ { "id" : "view005" , "name" : "Task List" , "type" : "list" } ] } usage Example:
get_view → Get a specific viewReturns full configuration details for a single view.
Inputs:
view_id Output:
{ "view" : { "id" : "view001" , "name" : "All Tasks" , "type" : "list" , "grouping" : { "field" : "status" }, "filters" : {} } } get_view_tasks → List tasks in a viewReturns the tasks visible in the specified view, with pagination support.
Inputs:
view_id page 0 Output:
{ "tasks" : [ { "id" : "abc123" , "name" : "Fix login bug" , "status" : { "status" : "in progress" } } Webhooks
get_webhooks → List all webhooks in a WorkspaceReturns all registered webhooks for the specified Workspace.
Inputs:
team_id Output:
{ "webhooks" : [ { "id" : "wh001" , "endpoint" : "https://example.com/webhook" , "events" : [ "taskCreated" , "taskUpdated" ], "health" : { "status" : "active" } create_webhook → Register a new webhookCreates a webhook that fires on specified ClickUp events.
Inputs:
team_id body Body fields:
endpoint events taskCreated taskUpdated taskDeleted listCreated spaceCreated update_webhook → Update a webhookUpdates the endpoint URL, event subscriptions, or status of a webhook.
Inputs:
webhook_id body Body fields:
endpoint events status active inactive Output:
delete_webhook → Delete a webhookPermanently removes a webhook registration.
Inputs:
webhook_id Output:
usage Example:
POST /mcp/clickup/delete_webhook
{ "webhook_id" : "wh001" } Docs
search_docs → Search for Docs in a WorkspaceSearches ClickUp Docs within the specified Workspace by query string.
Inputs:
team_id query Output:
{ "docs" : [ { "id" : "doc001" , "name" : "Engineering Handbook" , "date_created" : "1717100000000" } ] } get_doc_pages → List all pages in a DocReturns all pages within the specified Doc.
Inputs:
doc_id Output:
{ "pages" : [ { "id" : "page001" , "name" : "Introduction" , "date_created" : "1717100000000" }, { "id" : "page002" , "name" : "Setup Guide" , "date_created" : create_doc_page → Create a new page in a DocAdds a new page with a title and markdown content to the specified Doc.
Inputs:
doc_id body Body fields:
name content parent_page_id Output:
Chat
get_chat_channels → List chat channels in a WorkspaceReturns all chat channels available in the specified Workspace.
Inputs:
team_id Output:
{ "channels" : [ { "id" : "ch001" , "name" : "general" }, { "id" : "ch002" , "name" : "engineering" } ] } send_chat_message → Post a message to a chat channelSends a message to the specified chat channel.
Inputs:
channel_id body Body fields:
content Output:
{ "id" : "msg001" , "content" : "Hello team!" , "date" : "1717200000000" } Shared Hierarchy
get_shared_hierarchy → List resources shared with the authenticated userReturns all Spaces, Folders, Lists, and tasks that have been explicitly shared with the authenticated user.
Inputs:
team_id Output:
{ "shared" : { "tasks" : [{ "id" : "abc123" , "name" : "Fix login bug" }], "lists" : [{ "id" : "56789012" , "name" : "Backlog" }], "folders" : [] API Parameters Reference Common Parameters
team_id get_authorized_teams page archived true include_closed true order_by id created OAuth Setup Guide Credentials are injected server-side via fastmcp-credentials
Step 1: Create a ClickUp OAuth App
Log in to ClickUp
Go to Settings → Integrations → ClickUp API
Click Create an App
Enter a name and your redirect URI
Copy the Client ID and Client Secret
Step 2: Authorize and Obtain an Access Token
Direct users to the authorization URL:
https: //app.clickup.com/api?client_id={client_id}&redirect_uri={redirect_uri}
After the user approves, exchange the returned code
Troubleshooting Missing or Invalid Credential
Cause: OAuth access token not injected by the platform or the token is malformed.Solution:
Verify the credential is configured in your Curious Layer account for ClickUp.
Re-authorize the ClickUp integration to obtain a fresh access token.
Check that the platform is passing X-MCP-Cred-Access-Token
Insufficient Credits
Cause: API calls have exceeded your request limits.Solution:
Check credit usage in your Curious Layer dashboard.
Upgrade to a paid plan or add credits for higher limits.
Contact support for credit adjustments.
Cause: The body Solution:
Validate your JSON string before passing it as body
Ensure all required fields for the specific operation are included.
Check that numeric values (IDs, timestamps) are not wrapped in quotes where integers are expected.
Resource Not Found (404) POST /mcp/clickup/get_authorized_user ]
}
POST /mcp/clickup/get_authorized_teams "features"
: {
"due_dates"
: {
"enabled"
:
true
} }
}
]
}
POST /mcp/clickup/get_spaces
{ "team_id" : "9876543" } "enabled"
:
true
} }
}
POST /mcp/clickup/get_space
{ "space_id" : "90110011" } { "id" : "90110099" , "name" : "New Space" , "archived" : false }
POST /mcp/clickup/create_space
{ "team_id" : "9876543" , "body" : "{ \" name \" : \" New Space \" , \" multiple_assignees \" : true}" } "name"
:
"Engineering (Updated)"
,
"archived" : false
}
POST /mcp/clickup/update_space
{ "space_id" : "90110011" , "body" : "{ \" name \" : \" Engineering (Updated) \" }" } }
POST /mcp/clickup/get_folders
{ "space_id" : "90110011" } POST /mcp/clickup/get_folder
{ "folder_id" : "78901234" } POST /mcp/clickup/create_folder
{ "space_id" : "90110011" , "body" : "{ \" name \" : \" Sprint 2 \" }" } POST /mcp/clickup/update_folder
{ "folder_id" : "78901234" , "body" : "{ \" name \" : \" Sprint 1 (Completed) \" }" } }
]
}
POST /mcp/clickup/get_lists
{ "folder_id" : "78901234" } POST /mcp/clickup/get_folderless_lists
{ "space_id" : "90110011" } POST /mcp/clickup/get_list
{ "list_id" : "56789012" } Output:
{ "id" : "56789099" , "name" : "In Review" } POST /mcp/clickup/create_list
{ "folder_id" : "78901234" , "body" : "{ \" name \" : \" In Review \" , \" content \" : \" Tasks under code review \" }" } POST /mcp/clickup/create_folderless_list
{ "space_id" : "90110011" , "body" : "{ \" name \" : \" General \" }" }
{ "id" : "56789012" , "name" : "Backlog (Archived)" } POST /mcp/clickup/update_list
{ "list_id" : "56789012" , "body" : "{ \" name \" : \" Backlog (Archived) \" }" } created
updated
due_date
reverse
subtasks
statuses
assignees
due_date_gt
due_date_lt
date_created_gt
date_created_lt
date_updated_gt
date_updated_lt { "tasks" : [ { "id" : "abc123" , "name" : "Fix login bug" , "status" : { "status" : "in progress" , "color" : "#4169E1" }, "priority" : { "id" : "2" , "priority" : "high" }, "assignees" : [{ "id" : 1234567 , "username" : "jane_doe" }], "due_date" : "1717200000000" } ] } POST /mcp/clickup/get_tasks
{ "list_id" : "56789012" , "include_closed" : false , "order_by" : "due_date" } :
"Investigate session token expiry"
,
"status" : { "status" : "in progress" },
"priority" : { "priority" : "high" },
"assignees" : [{ "id" : 1234567 }],
"due_date" : "1717200000000" ,
"tags" : [],
"subtasks" : []
}
POST /mcp/clickup/get_task
{ "task_id" : "abc123" , "include_subtasks" : true }
priority 1 2 3 4
due_date
due_date_time
time_estimate
start_date
notify_all
parent { "id" : "abc999" , "name" : "Implement dark mode" , "status" : { "status" : "Open" }, "priority" : { "priority" : "normal" }, "assignees" : [] } POST /mcp/clickup/create_task
{ "list_id" : "56789012" , "body" : "{ \" name \" : \" Implement dark mode \" , \" priority \" : 3, \" assignees \" : [1234567]}" } null
assignees { "add" : [ id ], "rem" : [ id ]}
archived { "id" : "abc123" , "name" : "Fix login bug" , "status" : { "status" : "in review" }, "priority" : { "priority" : "urgent" } } POST /mcp/clickup/update_task
{ "task_id" : "abc123" , "body" : "{ \" status \" : \" in review \" , \" priority \" : 1}" } subtasks
space_ids
project_ids
list_ids
statuses
include_closed false
assignees
due_date_gt
due_date_lt
date_created_gt
date_created_lt
date_updated_gt
date_updated_lt { "tasks" : [ { "id" : "abc123" , "name" : "Fix login bug" , "list" : { "id" : "56789012" , "name" : "Backlog" }, "folder" : { "id" : "78901234" , "name" : "Sprint 1" }, "space" : { "id" : "90110011" } } ] } POST /mcp/clickup/get_filtered_team_tasks
{ "team_id" : "9876543" , "statuses" : "in progress,in review" , "assignees" : "1234567" } :
1234567
,
"username"
:
"jane_doe"
},
"date" : "1717200000000" ,
"resolved" : false
}
]
}
POST /mcp/clickup/get_task_comments
{ "task_id" : "abc123" } :
"55001199"
,
"comment" : [{ "text" : "Looks good, merging tomorrow." }],
"date" : "1717200000000"
}
POST /mcp/clickup/create_task_comment
{ "task_id" : "abc123" , "body" : "{ \" comment_text \" : \" Looks good, merging tomorrow. \" , \" notify_all \" : false}" } 1234567
},
"date" : "1717100000000"
}
]
}
POST /mcp/clickup/get_list_comments
{ "list_id" : "56789012" } "text"
:
"This list needs triage."
}],
"date" : "1717100000000"
}
POST /mcp/clickup/create_list_comment
{ "list_id" : "56789012" , "body" : "{ \" comment_text \" : \" This list needs triage. \" }" } POST /mcp/clickup/update_comment
{ "comment_id" : "55001122" , "body" : "{ \" resolved \" : true}" } { "data" : [ { "id" : "1234567890" , "task" : { "id" : "abc123" , "name" : "Fix login bug" }, "duration" : "3600000" , "start" : "1717100000000" , "user" : { "id" : 1234567 } } ] } POST /mcp/clickup/get_time_entries
{ "team_id" : "9876543" , "start_date" : 1717100000000 , "end_date" : 1717200000000 } "end" : "1717103600000"
}
}
POST /mcp/clickup/get_single_time_entry
{ "team_id" : "9876543" , "timer_id" : "1234567890" } { "data" : { "id" : "9876543210" , "duration" : "3600000" , "start" : "1717100000000" } } POST /mcp/clickup/create_time_entry
{ "team_id" : "9876543" , "body" : "{ \" tid \" : \" abc123 \" , \" start \" : 1717100000000, \" duration \" : 3600000}" } { "data" : { "id" : "1234567890" , "duration" : "7200000" } } POST /mcp/clickup/update_time_entry
{ "team_id" : "9876543" , "timer_id" : "1234567890" , "body" : "{ \" duration \" : 7200000}" } "timer_id"
:
"1234567890"
}
"9876543211"
,
"start" : "1717200000000" ,
"task" : { "id" : "abc123" }
}
}
POST /mcp/clickup/start_time_entry
{ "team_id" : "9876543" , "body" : "{ \" tid \" : \" abc123 \" , \" description \" : \" Working on login fix \" }" } POST /mcp/clickup/stop_time_entry
{ "team_id" : "9876543" } POST /mcp/clickup/get_running_time_entry
{ "team_id" : "9876543" } "jane@example.com"
,
"role"
:
2
} }
]
}
}
POST /mcp/clickup/get_workspace_members
{ "team_id" : "9876543" } POST /mcp/clickup/get_task_members
{ "task_id" : "abc123" }
POST /mcp/clickup/get_list_members
{ "list_id" : "56789012" }
"#4169E1"
}
]
}
POST /mcp/clickup/get_space_tags
{ "space_id" : "90110011" } { "success" : true }
POST /mcp/clickup/create_space_tag
{ "space_id" : "90110011" , "body" : "{ \" tag \" : { \" name \" : \" urgent \" , \" tag_fg \" : \" #FFFFFF \" , \" tag_bg \" : \" #FF0000 \" }}" } "success" : true
}
POST /mcp/clickup/update_space_tag
{ "space_id" : "90110011" , "tag_name" : "urgent" , "body" : "{ \" tag \" : { \" name \" : \" critical \" , \" tag_bg \" : \" #CC0000 \" }}" } ,
"tag_name" : "critical"
}
"tag_name" : "bug"
}
"tag_name" : "bug"
}
"description"
:
"Quarterly objectives"
,
"percent_completed" : 45 ,
"owners" : [{ "id" : 1234567 }]
}
]
}
POST /mcp/clickup/get_goals
{ "team_id" : "9876543" , "include_completed" : false } POST /mcp/clickup/get_goal
{ "goal_id" : "goal001" } { "goal" : { "id" : "goal002" , "name" : "Q3 OKRs" , "due_date" : "1727740800000" } } POST /mcp/clickup/create_goal
{ "team_id" : "9876543" , "body" : "{ \" name \" : \" Q3 OKRs \" , \" due_date \" : 1727740800000, \" owners \" : [1234567]}" } { "goal" : { "id" : "goal001" , "name" : "Q2 OKRs (Extended)" , "percent_completed" : 45 } } POST /mcp/clickup/update_goal
{ "goal_id" : "goal001" , "body" : "{ \" name \" : \" Q2 OKRs (Extended) \" }" } ,
"items" : []
}
}
POST /mcp/clickup/create_checklist
{ "task_id" : "abc123" , "body" : "{ \" name \" : \" Pre-launch QA \" }" } }
}
POST /mcp/clickup/update_checklist
{ "checklist_id" : "chk001" , "body" : "{ \" name \" : \" Pre-launch QA (Final) \" }" } { "id" : "item001" , "name" : "Smoke test all pages" , "resolved" : false }
]
}
}
POST /mcp/clickup/create_checklist_item
{ "checklist_id" : "chk001" , "body" : "{ \" name \" : \" Smoke test all pages \" , \" assignee \" : 1234567}" } { "checklist" : { "id" : "chk001" , "items" : [ { "id" : "item001" , "name" : "Smoke test all pages" , "resolved" : true } ] } } POST /mcp/clickup/update_checklist_item
{ "checklist_id" : "chk001" , "checklist_item_id" : "item001" , "body" : "{ \" resolved \" : true}" } ,
"checklist_item_id" : "item001"
}
}
]
}
POST /mcp/clickup/get_accessible_custom_fields
{ "list_id" : "56789012" } usage Example:
POST /mcp/clickup/set_custom_field_value
{ "task_id" : "abc123" , "field_id" : "field001" , "body" : "{ \" value \" : 8}" } "abc123"
,
"field_id" : "field001"
}
"gantt"
}
]
}
POST /mcp/clickup/get_team_views
{ "team_id" : "9876543" } POST /mcp/clickup/get_space_views
{ "space_id" : "90110011" }
POST /mcp/clickup/get_folder_views
{ "folder_id" : "78901234" }
POST /mcp/clickup/get_list_views
{ "list_id" : "56789012" }
POST /mcp/clickup/get_view
{ "view_id" : "view001" } ],
"last_page" : false
}
POST /mcp/clickup/get_view_tasks
{ "view_id" : "view001" , "page" : 0 } }
]
}
POST /mcp/clickup/get_webhooks
{ "team_id" : "9876543" } space_id
folder_id
list_id
task_id { "id" : "wh002" , "webhook" : { "id" : "wh002" , "endpoint" : "https://example.com/webhook" , "events" : [ "taskCreated" ] } } POST /mcp/clickup/create_webhook
{ "team_id" : "9876543" , "body" : "{ \" endpoint \" : \" https://example.com/webhook \" , \" events \" : [ \" taskCreated \" , \" taskUpdated \" ]}" } {
"webhook" : {
"id" : "wh001" ,
"endpoint" : "https://example.com/new-webhook" ,
"status" : "active"
}
}
POST /mcp/clickup/update_webhook
{ "webhook_id" : "wh001" , "body" : "{ \" endpoint \" : \" https://example.com/new-webhook \" }" } POST /mcp/clickup/search_docs
{ "team_id" : "9876543" , "query" : "onboarding" } "1717110000000"
}
]
}
POST /mcp/clickup/get_doc_pages
{ "doc_id" : "doc001" } "name"
:
"API Reference"
,
"date_created" : "1717200000000"
}
POST /mcp/clickup/create_doc_page
{ "doc_id" : "doc001" , "body" : "{ \" name \" : \" API Reference \" , \" content \" : \" ## Endpoints \\ n... \" }" } POST /mcp/clickup/get_chat_channels
{ "team_id" : "9876543" } POST /mcp/clickup/send_chat_message
{ "channel_id" : "ch001" , "body" : "{ \" content \" : \" Hello team! \" }" } }
}
POST /mcp/clickup/get_shared_hierarchy
{ "team_id" : "9876543" } updated
due_date
reverse true order_by
Priority Levels Value Priority 1 Urgent 2 High 3 Normal 4 Low
Timestamps All date/time values use Unix milliseconds (epoch × 1000).
example: 1717200000000 → 2024-06-01 00 : 00 : 00 UTC
format: numeric string Example: "9876543" format: numeric string Example: "90110011" format: alphanumeric string Example: "abc123" format: numeric string Example: "1234567890"
Webhook Events Event Description taskCreated A task was created taskUpdated A task field was changed taskDeleted A task was deleted taskCommentPosted A comment was added to a task taskStatusUpdated A task's status changed listCreated A list was created listUpdated A list was updated listDeleted A list was deleted folderCreated A folder was created folderUpdated A folder was updated folderDeleted A folder was deleted spaceCreated A space was created spaceUpdated A space was updated spaceDeleted A space was deleted
POST https://api.clickup.com/api/v2/oauth/token Content-Type: application/json
{ "client_id" : "YOUR_CLIENT_ID", "client_secret" : "YOUR_CLIENT_SECRET", "code" : "AUTHORIZATION_CODE" }
The response contains the access_token
Provide the access token to the Curious Layer platform. It will be injected into every tool call via the X-MCP-Cred-Access-Token
Required Scopes ClickUp's OAuth does not use granular scopes. An authorized token grants access to all Workspaces and resources the user has permission to see within their account.
Cause: An ID refers to a resource that does not exist, has been deleted, or belongs to a different Workspace.Solution:
Verify the ID using the corresponding get_* get_authorized_teams
Confirm the resource belongs to the Workspace associated with the authenticated token.
Check whether the resource was archived (use archived: true
Authentication Token Invalid or Expired
Cause: ClickUp rejected the access token.Solution:
Re-authorize the ClickUp integration on the Curious Layer platform.
Verify the token has not been revoked in ClickUp Settings → Integrations.
Obtain a fresh token via the OAuth flow and update the platform credential.
Rate Limit Exceeded (429)
Cause: Too many requests in a short period.Solution:
Reduce the frequency of API calls.
Add delays between bulk operations.
Refer to ClickUp Rate Limits for current limits.
