ClickUp through One
ClickUp offers a unified, cloud-based work platform that consolidates tasks, docs, chat, whiteboards, time tracking, automations, AI-powered workflows, and customizable views—enabling teams of any size or industry to manage projects, collaborate, and streamline productivity within a single, scalable workspace.
One exposes ClickUp through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform click-up if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm ClickUp is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real ClickUp account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Tasks
| Action |
Method |
Path |
Action id |
| Get a Task |
GET |
/task/{{taskId}} |
conn_mod_def::GJ1NYOSxJAc::GS03N1JBS7Gtdcvi7gpS4Q |
| Get a Task’s Time in Status |
GET |
/v2/task/{{taskId}}/time_in_status |
conn_mod_def::GJ1NYYqQc60::EnIYcbzBSGWv8Bb7CIIfSw |
| Get Bulk Tasks' Time in Status |
GET |
/v2/task/bulk_time_in_status/{{taskIds}} |
conn_mod_def::GJ1NX1SNkHY::hhzq6zfWSai9eS4urKhxuA |
| Get Filtered Team Tasks (List a Workspace’s Tasks by Filter) |
GET |
/v2/team/{{teamId}}/task |
conn_mod_def::GJ1NYDORpUY::6-x-1O0hShKg4Q7pWppKlw |
| List Tasks in a List |
GET |
/v2/list/{{listId}}/task |
conn_mod_def::GJ1NYoUtZHs::W4JHGlAnRLiNoXDYORTxwQ |
| List Tasks in a View |
GET |
/v2/view/{{viewId}}/task |
conn_mod_def::GJ1Nd0zQaOY::Uhk2G-6zRdijUKGb1m-fnA |
| Add a Task to an Additional List |
POST |
/v2/list/{{listId}}/task/{{taskId}} |
conn_mod_def::GJ1NS3ARiec::o5jJzOBMQAmOxSr4Ps2Dnw |
| Add Guest to a Task |
POST |
/v2/task/{{taskId}}/guest/{{guestId}} |
conn_mod_def::GJ1NR3DBv1Q::auF2alciTzSX6iWw2yQO_g |
| Add Tag to a Task |
POST |
/v2/task/{{taskId}}/tag/{{tagName}} |
conn_mod_def::GJ1NVWV9vwA::05ksG8agQaGmsvrwg5MIdw |
| Create a Task From a Template in a List |
POST |
/v2/list/{{listId}}/taskTemplate/{{templateId}} |
conn_mod_def::GJ1NXjFzd1w::LGdCH85ISXiy0Ivl_1Rm1A |
| Create a Task in a List |
POST |
/v2/list/{{listId}}/task |
conn_mod_def::GJ1NXbQ4T7g::GQuOI_YJSPKX3BRGFScliQ |
| Delete a Task |
DELETE |
/task/{{taskId}} |
conn_mod_def::GJ1NXqpLDP4::YOTezrkvT56i3uNWgVbZ2Q |
9 more Tasks actions are available through search.
Lists
| Action |
Method |
Path |
Action id |
| Get a List |
GET |
/list/{{listId}} |
conn_mod_def::GJ1NTxDQHbY::L7iWqy3yTaCTQzXUI8Mh3w |
| List a Folder’s Lists |
GET |
/folder/{{folderId}}/list |
conn_mod_def::GJ1NT46rNs0::0xCGHGlKSK-TyDwksjrYXQ |
| List Folderless Lists in a Space |
GET |
/v2/space/{{spaceId}}/list |
conn_mod_def::GJ1NTqJRX7k::8oFOB0BbTxa0XNriUIqpgA |
| Add Guest to a List |
POST |
/v2/list/{{listId}}/guest/{{guestId}} |
conn_mod_def::GJ1NRua2lqQ::nBqUsxh2T6ajwfk9seH1PQ |
| Create a Folder List (Create List) |
POST |
/v2/folder/{{folderId}}/list |
conn_mod_def::GJ1NTGC8kfE::_WWCctSFRMyB8xAu8VZZxQ |
| Create a Folderless List in a Space |
POST |
/space/{{spaceId}}/list |
conn_mod_def::GJ1NS-zQkbQ::3uXmJ1yuQdCse_GY9QxmhA |
| Create a List From a Template in a Folder |
POST |
/v2/folder/{{folderId}}/list_template/{{templateId}} |
conn_mod_def::GJ1NTOZ23zk::UpgMaS-zSYirf-hgvJxA7A |
| Create a List From a Template in a Space |
POST |
/v2/space/{{spaceId}}/list_template/{{templateId}} |
conn_mod_def::GJ1NTY_6TAQ::OxzDq1RSQNq4dFlnyA2X5g |
| Delete a Workspace List |
DELETE |
/list/{{listId}} |
conn_mod_def::GJ1NTgGOVLI::-BunrEnoTz6uZyiMUBbAGQ |
| Remove a Guest From a List |
DELETE |
/v2/list/{{listId}}/guest/{{guestId}} |
conn_mod_def::GJ1NSeU0_iM::6V0HUDVJQMW1TmKGOF_QMQ |
| Update a List |
PUT |
/list/{{listId}} |
conn_mod_def::GJ1NUH9F25Q::MTqFXqmSS3moadXyrHompQ |
TimeEntries
| Action |
Method |
Path |
Action id |
| Get a Workspace Time Entry |
GET |
/v2/team/{{teamId}}/time_entries/{{timerId}} |
conn_mod_def::GJ1NaATG8Kk::lVMqOYm7TuG9B8QiPlpOtA |
| Get a Workspace’s Current Running Time Entry |
GET |
/team/{{teamId}}/time_entries/current |
conn_mod_def::GJ1NZ3Ac9JM::lyPdRrhKRqSPWzhxdvAukg |
| Get Time Entries Within a Date Range (for a Workspace) |
GET |
/team/{{teamId}}/time_entries |
conn_mod_def::GJ1NaQD1Fgk::vcyS1pdLSLWUI6JqY8J-9w |
| Add Tags to a Workspace’s Time Entries |
POST |
/team/{{teamId}}/time_entries/tags |
conn_mod_def::GJ1NZKVNRyU::I1hyxcPfTNWFumq0LgYAlA |
| Create a Time Entry for a Workspace (Team) |
POST |
/team/{{teamId}}/time_entries |
conn_mod_def::GJ1NZceWLDg::TZe6fzDlSdWlQmf1ThpfJw |
| Delete a Workspace Time Entry |
DELETE |
/v2/team/{{teamId}}/time_entries/{{timerId}} |
conn_mod_def::GJ1NZn5o63o::GgwC_LCTQVuMzWT4rPpfww |
| Remove Tags From a Workspace's Time Entries |
DELETE |
/v2/team/{{teamId}}/time_entries/tags |
conn_mod_def::GJ1Nag8jtD8::Z4i094nqQjmkUmyXwDZdZw |
| Start a Workspace Time Entry Timer (Authenticated User) |
POST |
/v2/team/{{teamId}}/time_entries/start |
conn_mod_def::GJ1NatOCQvo::JvahSr7BQCyO5MfdBt03AA |
| Stop a Workspace Time Entry Timer (Authenticated User) |
POST |
/v2/team/{{teamId}}/time_entries/stop |
conn_mod_def::GJ1Na2t14Iw::ApuC6gLnRO-wRGCqEx5mgg |
| Update a Workspace Time Entry |
PUT |
/team/{{teamId}}/time_entries/{{timerId}} |
conn_mod_def::GJ1Na_W43Ug::LshdkgjbRK-5DBQIFUEruw |
Views
| Action |
Method |
Path |
Action id |
| Get a View |
GET |
/view/{{viewId}} |
conn_mod_def::GJ1NdryfdXM::qiJ3mJFWQwqyOl3K-GeHcw |
| List a List’s Views |
GET |
/list/{{listId}}/view |
conn_mod_def::GJ1NdeCzx-U::G7Z3euUVSbanBSy8k559xw |
| List a Space’s Views |
GET |
/space/{{spaceId}}/view |
conn_mod_def::GJ1NdlAGQCw::43hN_vLMTy6U2ypXVJofcQ |
| List a Workspace’s Everything-Level Views |
GET |
/team/{{teamId}}/view |
conn_mod_def::GJ1Nd7cxtXI::-xKrz5qHSdygipbnbFnhrg |
| Create a Folder View |
POST |
/folder/{{folderId}}/view |
conn_mod_def::GJ1Ncurlc9E::b_RN1mKNSaScPV4yMoxmMw |
| Create a List View |
POST |
/v2/list/{{listId}}/view |
conn_mod_def::GJ1Nc10fYUs::54EKcGn-QrKaJwyUmkEDcg |
| Create a Workspace (Everything Level) View |
POST |
/v2/team/{{teamId}}/view |
conn_mod_def::GJ1NdJK-0bA::334Gx3F1RUu21kEWUn--1A |
| Delete a View |
DELETE |
/view/{{viewId}} |
conn_mod_def::GJ1NdQFggug::xWp-0tF6TEWeBk6FdAcx1g |
| Update a View |
PUT |
/view/{{viewId}} |
conn_mod_def::GJ1NeEkXDZ8::_QmPG4XMSTOJ7ln4sSJ-iQ |
Folders
| Action |
Method |
Path |
Action id |
| Get a Folder |
GET |
/folder/{{folderId}} |
conn_mod_def::GJ1NQJqMB1w::9T5SGrkbQzajUo7eGafuqg |
| List a Space’s Folders |
GET |
/space/{{spaceId}}/folder |
conn_mod_def::GJ1NQRFFRE0::owJX2ismRVKcgu0ylO9NmQ |
| Add a Guest to a Folder |
POST |
/v2/folder/{{folderId}}/guest/{{guestId}} |
conn_mod_def::GJ1NRmiqraY::FhIMqs7aTpKM_hBOZpzvsQ |
| Create a Folder From a Template in a Space |
POST |
/v2/space/{{spaceId}}/folder_template/{{templateId}} |
conn_mod_def::GJ1NP7sjPdI::BIaM1gM1Q6mo9LExZ500-Q |
| Create a Space Folder |
POST |
/v2/space/{{spaceId}}/folder |
conn_mod_def::GJ1NPxoYM2c::dLLsnxZMTIWLvMWTxThxUQ |
| Delete a Folder |
DELETE |
/folder/{{folderId}} |
conn_mod_def::GJ1NQC-nnqY::6XrGcye5T1W1FXlNhFlxXg |
| Remove a Guest From a Folder |
DELETE |
/folder/{{folderId}}/guest/{{guestId}} |
conn_mod_def::GJ1NSWeeBoU::upmEKQR-R-Sai-qi-0dTrg |
| Update a Folder |
PUT |
/folder/{{folderId}} |
conn_mod_def::GJ1NQYhQjgs::of-LVBEmRtGMp1QR39SMaQ |
ChatChannels
| Action |
Method |
Path |
Action id |
| Retrieve a Workspace Chat Channel |
GET |
/v3/workspaces/{{workspaceId}}/chat/channels/{{channelId}} |
conn_mod_def::GJ1OGQcUyT8::xjte8bCCT2qt9mzwe2LhtA |
| Retrieve a Workspace’s Chat Channels |
GET |
/v3/workspaces/{{workspaceId}}/chat/channels |
conn_mod_def::GJ1OG1lZ5lk::cmauRAP8QzinKDTvKmQO6A |
| Create a Chat Channel on a Space, Folder, or List (Location) |
POST |
/v3/workspaces/{{workspaceId}}/chat/channels/location |
conn_mod_def::GJ1OFNjMzDY::YoZUeAmkQ9eGGVXgpz0LFg |
| Create a Workspace Chat Channel |
POST |
/v3/workspaces/{{workspaceId}}/chat/channels |
conn_mod_def::GJ1OFFjViwg::S5hQBDRYQQi9DBbZHEG64Q |
| Create a Workspace Direct Message Chat Channel |
POST |
/v3/workspaces/{{workspaceId}}/chat/channels/direct_message |
conn_mod_def::GJ1OFW0Z3TU::X1-uhiIcT-2dTqYhUilf8Q |
| Delete a Workspace Chat Channel |
DELETE |
/v3/workspaces/{{workspaceId}}/chat/channels/{{channelId}} |
conn_mod_def::GJ1OF14b_oU::FuMJr1nEQp6acFzlc8RPFw |
| Update a Workspace's Chat Channel |
PATCH |
/v3/workspaces/{{workspaceId}}/chat/channels/{{channelId}} |
conn_mod_def::GJ1OHnJ4zhk::NYarIkneRIC6_fEk-0vw6w |
Goals
| Action |
Method |
Path |
Action id |
| Get a Goal |
GET |
/goal/{{goalId}} |
conn_mod_def::GJ1NRM-pawg::bjhFv4l6QrWqIxaAPm4o6Q |
| List a Workspace's Goals |
GET |
/team/{{teamId}}/goal |
conn_mod_def::GJ1NRWxJITE::tUSHPMALTLqWU706SG9cgQ |
| Create a Workspace Goal |
POST |
/v2/team/{{teamId}}/goal |
conn_mod_def::GJ1NQfokOzE::Pp7BREZaRpKIBSOeZNQ30w |
| Delete a Workspace Goal |
DELETE |
/goal/{{goalId}} |
conn_mod_def::GJ1NQxq1xKQ::9suLQ93vTzmT6sTwg1qIOg |
| Update a Goal |
PUT |
/goal/{{goalId}} |
conn_mod_def::GJ1NRdtCSLY::IYAReXSZR_-idb42FEQHDw |
Spaces
| Action |
Method |
Path |
Action id |
| Get a Space |
GET |
/space/{{spaceId}} |
conn_mod_def::GJ1NU8B3LnA::qbng_scvS2yCZwrgSMwkng |
| List a Workspace’s Spaces |
GET |
/team/{{teamId}}/space |
conn_mod_def::GJ1NVFt0Eag::qj1VbfWCSJe2Zb4YUgmaUw |
| Create a Workspace Space |
POST |
/v2/team/{{teamId}}/space |
conn_mod_def::GJ1NUscGXs8::04lnbOA0RqKUgfhd-Q8Xeg |
| Delete a Workspace Space |
DELETE |
/space/{{spaceId}} |
conn_mod_def::GJ1NU1RlzzQ::fKI7XSmeQl-5NipEs6U9Pw |
| Update a Space |
PUT |
/v2/space/{{spaceId}} |
conn_mod_def::GJ1NVNwFWuk::cNssm4v5SsG4LRogYhY88A |
Guests
| Action |
Method |
Path |
Action id |
| Get a Workspace Guest |
GET |
/v2/team/{{teamId}}/guest/{{guestId}} |
conn_mod_def::GJ1NSGmz3so::JtIgXee_QsuiuVsPeAtBOA |
| Edit a Guest on a Workspace |
PUT |
/team/{{teamId}}/guest/{{guestId}} |
conn_mod_def::GJ1NR_EzoOk::tcbsfsToRd2kJqPwHQTfvA |
| Invite a Guest to a Workspace |
POST |
/team/{{teamId}}/guest |
conn_mod_def::GJ1NSOVa_K4::11XBqbeBRdCR-Tf9SxNX4g |
| Remove a Guest From a Workspace |
DELETE |
/team/{{teamId}}/guest/{{guestId}} |
conn_mod_def::GJ1NSvvmC7o::PPRq4-LAQGmshVLbJqSt1Q |
SpaceTags
| Action |
Method |
Path |
Action id |
| List a Space’s Tags |
GET |
/space/{{spaceId}}/tag |
conn_mod_def::GJ1NV1JqfRc::iF3wVHcJROGSSKaXJ80MfA |
| Create a Space Tag |
POST |
/v2/space/{{spaceId}}/tag |
conn_mod_def::GJ1NVfgcADQ::KzTWANGmRj2hgZdaanJxHg |
| Delete a Space Tag |
DELETE |
/v2/space/{{spaceId}}/tag/{{tagName}} |
conn_mod_def::GJ1NVmvqC9U::ZEMrYrEkSIq3ziIszbqdtQ |
| Edit a Space Tag |
PUT |
/v2/space/{{spaceId}}/tag/{{tagName}} |
conn_mod_def::GJ1NVuFq1Iw::t-YHm1eYQISd8u22mh9FPQ |
Webhooks
| Action |
Method |
Path |
Action id |
| List a Workspace's Webhooks |
GET |
/v2/team/{{teamId}}/webhook |
conn_mod_def::GJ1NedRPmXs::4Ex8rIB5T_qWHv_dj5tgrw |
| Create a Workspace Webhook |
POST |
/v2/team/{{teamId}}/webhook |
conn_mod_def::GJ1NeMF9EG8::r4hUAnV8Q9Ohyd9JsGqnDQ |
| Delete a Webhook |
DELETE |
/webhook/{{webhookId}} |
conn_mod_def::GJ1NeV5fOwQ::DeHeW0QvRgONKAvTDBQThg |
| Update a Webhook |
PUT |
/webhook/{{webhookId}} |
conn_mod_def::GJ1NekGz4pc::Hiy6BUT6SHy6ZNoqYGJdlg |
Comments
| Action |
Method |
Path |
Action id |
| Get Threaded Comments for a Comment |
GET |
/comment/{{commentId}}/reply |
conn_mod_def::GJ1NOp_-XNQ::WZN8-Gb3QmWhB-BG2iJ6qw |
| List Comments for a List |
GET |
/list/{{listId}}/comment |
conn_mod_def::GJ1NOZYpbfI::gdNE2CDCRI-ciJvGXgF8Cw |
| Delete a Task Comment |
DELETE |
/comment/{{commentId}} |
conn_mod_def::GJ1NOHunFWQ::qn7Z0PxbRniIY3JUEOYB_g |
| Update a Comment |
PUT |
/comment/{{commentId}} |
conn_mod_def::GJ1NOwisnhw::pSSyfPlISRSspvypNzpxHA |
ChecklistItems
| Action |
Method |
Path |
Action id |
| Create a Checklist Item in a Checklist |
POST |
/v2/checklist/{{checklistId}}/checklist_item |
conn_mod_def::GJ1NWTHrLXU::k9pV2PDuT7mgRwlGpjfdiw |
| Delete a Checklist's Checklist Item |
DELETE |
/checklist/{{checklistId}}/checklist_item/{{checklistItemId}} |
conn_mod_def::GJ1NWhYFAtM::C6_pSKWTQ-qW9s8-Ao1eww |
| Edit a Checklist’s Item |
PUT |
/v2/checklist/{{checklistId}}/checklist_item/{{checklistItemId}} |
conn_mod_def::GJ1NWxslu2Y::B05M4qBaTUCHS7m1NV9_gg |
UserGroups
| Action |
Method |
Path |
Action id |
| Create a Workspace User Group |
POST |
/v2/team/{{teamId}}/group |
conn_mod_def::GJ1NbzgNyxc::47db8qH2SQ-_elHfg6s5hQ |
| Delete a Workspace User Group |
DELETE |
/group/{{groupId}} |
conn_mod_def::GJ1Nb6sv2Os::rkV5dxAXRFubUTkfni2bcw |
| Update a User Group |
PUT |
/group/{{groupId}} |
conn_mod_def::GJ1NcKDm80c::mDOcTeKvSfS6GLwk4CF9dg |
Docs
| Action |
Method |
Path |
Action id |
| Fetch a Workspace Doc |
GET |
/v3/workspaces/{{workspaceId}}/docs/{{docId}} |
conn_mod_def::GJ1OIYkCWs8::kymbBz3cQRmInw4uC03tAA |
2 more Docs actions are available through search.
This lists 90 of 170 actions. For anything not here, call search_one_platform_actions with platform click-up. The full catalog is at https://www.withone.ai/knowledge/click-up.
When a call fails
The error comes from ClickUp, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/click-up
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai