ClickUp

Project and task tracking. Create and move tasks, comment on them, break them into checklists, and organize the lists holding them.

Measured routing accuracy

98 golden cases replayed through the router over the whole index: measured over corpus ea4f12ad2948 (65 toolkits, 2283 tools indexed and 13 declared uncallable), 39 cases written by hand and 59 cases from the paraphrase pass. A case counts as top-1 when its gold tool ranked first and top-8 when it reached the slate at all.

The sweep is offline: the reranker is a deterministic identity fake that returns candidates in the order retrieval produced them, so top-1 measures retrieval order rather than a reranked slate. just eval-live measures the same cases through the live reranker.

Authentication

Connect an entity with ConnectionsService.InitiateConnection, naming this toolkit's slug. Credentials stay in the connections vault; callers hold connected-account ids only.

oauth2

api_key

Submit the key with ConnectionsService rather than putting it in a request; it is sealed at rest and never returned.

Tools

39 action tools. The catalog-wide slug is clickup.<tool>, which is what search_tools returns and call_tool takes.

clickup.list_workspaces

List every ClickUp workspace (called a "team" in ClickUp's API) the connected account belongs to, with its members. Use first when a call below needs a team_id and the user has not named one, or to answer who is on a ClickUp workspace.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /team.

Takes no arguments.

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what clickup workspaces do I have", "show every clickup team I belong to", "which clickup workspaces can I use", "list the places I have access to in clickup", "what clickup teams can I access right now".

clickup.get_current_user

Get the ClickUp profile of the connected account itself: id, username, and email. Use to answer "who am I in ClickUp" or to get the caller's own user id for assigning a ClickUp task to itself.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /user.

Takes no arguments.

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "who am I logged in as in clickup", "what's my own clickup profile", "show my clickup account info".

clickup.list_spaces

List the spaces in a ClickUp workspace. Use when the user asks what ClickUp spaces exist, or to find a space_id for a folder or list call. For one space's own detail use get_space.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /team/{{params.team_id}}/space.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what clickup spaces exist in this workspace", "show me every clickup space we have set up", "find the clickup space id for engineering", "what areas exist in this clickup workspace".

clickup.get_space

Get one ClickUp space's own detail by id: name, privacy, and its enabled features (due dates, time tracking, tags). Use when the user names a specific ClickUp space. For the whole list use list_spaces.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /space/{{params.space_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "tell me about this clickup space", "is this clickup space private or shared", "what features are turned on for this clickup space", "pull up clickup space details", "is this clickup area private or shared with everyone".

clickup.create_space

Create a new space in a ClickUp workspace. Use when the user wants to start, set up, or spin up a new ClickUp space to organize folders and lists under.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /team/{{params.team_id}}/space.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "spin up a new clickup space for the design team", "start a fresh space in clickup", "set up a clickup space to organize this initiative", "spin up a fresh area for the design team in clickup".

clickup.update_space

Edit an existing ClickUp space's name, privacy, or color. Use when the user wants to rename or reconfigure a ClickUp space itself, not the folders or lists inside it.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /space/{{params.space_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "rename this clickup space", "make this clickup space private", "change the color on this clickup space", "give this clickup area a new name".

clickup.delete_space

Permanently delete a ClickUp space and every folder, list, and task inside it. Use when the user explicitly asks to delete or remove a whole ClickUp space. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /space/{{params.space_id}}.

Arguments:

Also retrieved by: "remove this whole clickup space", "get rid of a clickup space for good", "wipe out a clickup space entirely", "get rid of this clickup area for good".

clickup.list_folders

List the folders in a ClickUp space. Use when the user asks what ClickUp folders exist, or to find a folder_id for a list call. For one folder's own detail use get_folder.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /space/{{params.space_id}}/folder.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what clickup folders exist in this space", "show me every clickup folder here", "find the clickup folder id for sprint planning", "what groupings exist inside this clickup space".

clickup.get_folder

Get one ClickUp folder's own detail by id: name and the lists inside it. Use when the user names a specific ClickUp folder. For the whole list use list_folders.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /folder/{{params.folder_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "tell me about this clickup folder", "what clickup lists are inside this folder", "pull up clickup folder details", "what's inside this clickup grouping".

clickup.create_folder

Create a new folder in a ClickUp space. Use when the user wants to add, create, or set up a new ClickUp folder to group lists under, before adding lists to it with create_list.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /space/{{params.space_id}}/folder.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "add a new folder to this clickup space", "set up a clickup folder to group our lists", "create a clickup folder for this quarter's work", "set up a new grouping under this clickup space".

clickup.update_folder

Rename an existing ClickUp folder. Use when the user wants to rename or relabel a ClickUp folder itself, not the lists inside it.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /folder/{{params.folder_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "rename this clickup folder", "relabel the sprint planning folder in clickup", "change the name on an existing clickup folder", "relabel this clickup grouping".

clickup.delete_folder

Permanently delete a ClickUp folder and every list and task inside it. Use when the user explicitly asks to delete or remove a whole ClickUp folder. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /folder/{{params.folder_id}}.

Arguments:

Also retrieved by: "remove this whole clickup folder", "get rid of a clickup folder and everything in it", "wipe out a clickup folder entirely", "wipe out this clickup grouping for good".

clickup.list_lists

List the ClickUp lists inside a folder. Use when the user asks what lists a ClickUp folder has. For lists that live directly under a space with no folder use list_folderless_lists instead.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /folder/{{params.folder_id}}/list.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what clickup lists are inside this folder", "show me every clickup list under sprint planning", "find the clickup list id for a specific board in this folder", "show me every board nested under this clickup folder".

clickup.list_folderless_lists

List the ClickUp lists that live directly under a space, with no folder. Use when the user asks what lists a ClickUp space has and the space is not organized into folders. For lists inside a folder use list_lists.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /space/{{params.space_id}}/list.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what clickup lists does this space have with no folder", "show me the clickup lists directly under this space", "find a clickup board that isn't nested inside any folder".

clickup.get_list

Get one ClickUp list's own detail by id: name, its folder and space, task count, and default status. Use when the user names a specific ClickUp list.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /list/{{params.list_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "tell me about this clickup list", "what's the default status on this clickup list", "pull up clickup list details", "what's the default status on this clickup board".

clickup.create_list

Create a new ClickUp list inside a folder. Use when the user wants to add, create, or set up a new list to hold ClickUp tasks, and the target already has a folder. For a list with no folder use create_folderless_list.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /folder/{{params.folder_id}}/list.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "add a new clickup list inside this folder", "set up a clickup list to hold tasks in this folder", "create a fresh clickup list under sprint planning".

clickup.create_folderless_list

Create a new ClickUp list directly under a space, with no folder. Use when the user wants a new list to hold ClickUp tasks and the space is not organized into folders. For a list inside an existing folder use create_list.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /space/{{params.space_id}}/list.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "add a new clickup list directly under this space", "set up a clickup list with no folder", "create a fresh clickup list that isn't nested in a folder".

clickup.update_list

Edit an existing ClickUp list's name, description, due date, or priority. Use when the user wants to rename or reconfigure a ClickUp list itself, not the tasks inside it.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /list/{{params.list_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "rename this clickup list", "change the due date on this clickup list", "edit the clickup list description", "push out the due date on this clickup board".

clickup.delete_list

Permanently delete a ClickUp list and every task inside it. Use when the user explicitly asks to delete or remove a whole ClickUp list. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /list/{{params.list_id}}.

Arguments:

Also retrieved by: "remove this whole clickup list", "get rid of a clickup list and everything on it", "wipe out a clickup list entirely", "wipe out this clickup board and everything on it".

clickup.list_tasks

List the ClickUp tasks in one list. Use for what's on this ClickUp list. For a multi-filter query across a whole workspace use search_tasks instead. For one known task use get_task.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /list/{{params.list_id}}/task.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what's on this clickup list right now", "show every to-do in this clickup list", "what does the team have open on this clickup board", "what's on this clickup board at the moment".

clickup.get_task

Get one ClickUp task's full detail by id: name, description, status, priority, due date, assignees, tags, and its list and space. Use when the user names a specific ClickUp task. For many tasks at once use list_tasks or search_tasks.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /task/{{params.task_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "pull up the details on this clickup to-do", "what does this clickup ticket say", "show me one specific clickup task", "what's the status of this clickup card".

clickup.create_task

Create a new task in a ClickUp list. Use when the user wants to add, file, or log something to do in ClickUp. Requires a list and a name; description, assignees, tags, priority, and due date are optional.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /list/{{params.list_id}}/task.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "add a new to-do to this clickup list", "file a new ticket under this clickup list", "log something for someone to do in clickup", "open a new card on this clickup list".

clickup.update_task

Edit an existing ClickUp task's name, description, status, priority, due date, or assignees. Use when the user wants to change, retitle, reassign, reschedule, or move a ClickUp task to a different status.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /task/{{params.task_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "reschedule this clickup to-do", "reassign this clickup ticket to someone else", "move this clickup card to a different status", "change the priority on this clickup task".

clickup.delete_task

Permanently delete a ClickUp task. Use when the user wants to delete or remove a ClickUp task entirely, not just mark it done. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /task/{{params.task_id}}.

Arguments:

Also retrieved by: "remove this clickup to-do entirely", "get rid of this clickup ticket for good", "wipe this clickup card off the list".

clickup.search_tasks

Filter ClickUp tasks across a whole workspace by status, assignee, tag, or due date, without needing to know which list they're in. Has no free-text keyword search; ClickUp's API filters by these fields only, and each filter here takes one value, not a set (ClickUp expects a repeated query key for more than one, which a request template cannot express; narrow with one status, assignee, or tag per call instead). For tasks in one known list use list_tasks; for one known task use get_task.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /team/{{params.team_id}}/task.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "find every clickup task assigned to sam across the workspace", "what clickup tickets are still open anywhere in the workspace", "look through the whole clickup workspace for tasks tagged urgent", "filter every clickup task due before Friday".

clickup.list_task_comments

List the comments on a ClickUp task, newest first. Use when the user wants to read the discussion or history on a ClickUp task.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /task/{{params.task_id}}/comment.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what have people said on this clickup ticket", "read the notes on this clickup to-do", "show the conversation history on this clickup card".

clickup.add_task_comment

Post a new comment on a ClickUp task. Use when the user wants to comment, note, or leave an update on a ClickUp task. To change a comment already posted use update_comment.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /task/{{params.task_id}}/comment.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "leave a note on this clickup ticket", "post an update for the team on this clickup to-do", "tell them the fix shipped on this clickup card".

clickup.update_comment

Edit the text of a ClickUp comment already posted, or mark it resolved. Use when the user wants to fix, correct, or resolve something written on a ClickUp task.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /comment/{{params.comment_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "fix a typo in my last note on this clickup task", "correct what I wrote on this clickup ticket", "mark this clickup comment resolved".

clickup.delete_comment

Permanently delete a comment from a ClickUp task. Use when the user wants to delete or remove a ClickUp comment, not the whole task. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /comment/{{params.comment_id}}.

Arguments:

Also retrieved by: "remove that note on this clickup task", "take down what I posted on this clickup ticket by mistake", "delete a remark on this clickup ticket".

clickup.create_checklist

Add a new checklist to a ClickUp task. Use when the user wants to break a ClickUp task into steps, or start a checklist on it, before adding items with create_checklist_item.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /task/{{params.task_id}}/checklist.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "break this clickup ticket into steps", "add a checklist to this clickup to-do", "start a step-by-step list on this clickup card".

clickup.delete_checklist

Permanently delete a ClickUp checklist and every item on it. Use when the user wants to delete or remove a whole checklist from a ClickUp task, not one item on it. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /checklist/{{params.checklist_id}}.

Arguments:

Also retrieved by: "remove this whole checklist from a clickup task", "get rid of a clickup checklist entirely", "wipe out the steps on this clickup ticket".

clickup.create_checklist_item

Add a new item to an existing ClickUp checklist. Use when the user wants to add a step, or a checklist line, to a ClickUp checklist that already exists.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /checklist/{{params.checklist_id}}/checklist_item.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "add a step to this clickup checklist", "add a new clickup checklist line", "put another item on this clickup list of steps".

clickup.update_checklist_item

Rename a ClickUp checklist item, reassign it, or check it off. Use when the user wants to mark a step done, reopen it, or edit its text on a ClickUp task.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /checklist/{{params.checklist_id}}/checklist_item/{{params.checklist_item_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "check off this clickup checklist step", "mark this clickup checklist item done", "reopen a clickup checklist step that was closed", "rename this clickup checklist line".

clickup.delete_checklist_item

Permanently delete one item from a ClickUp checklist, leaving the rest of the checklist in place. Use when the user wants to delete or remove a single checklist item, not the whole checklist. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /checklist/{{params.checklist_id}}/checklist_item/{{params.checklist_item_id}}.

Arguments:

Also retrieved by: "remove this one step from a clickup checklist", "get rid of a single clickup checklist line", "delete an item from this clickup checklist".

clickup.list_space_tags

List the tags defined in a ClickUp space, e.g. "urgent" or "blocked". Use when the user asks what labels or tags exist in ClickUp, or to check a tag name before add_tag_to_task.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /space/{{params.space_id}}/tag.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what labels exist in this clickup space", "show me every clickup tag we have set up here", "find the clickup tag name for urgent".

clickup.create_space_tag

Create a new tag in a ClickUp space. Use when the user wants a new label that does not exist yet in ClickUp, before applying it with add_tag_to_task.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /space/{{params.space_id}}/tag.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "make a new label called blocked in clickup", "set up a fresh tag in this clickup space", "add a new clickup marker we can apply to tickets".

clickup.delete_space_tag

Permanently delete a tag from a ClickUp space, removing it from every task that carried it. Use when the user wants to delete or remove a ClickUp tag itself, not just untag one task. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /space/{{params.space_id}}/tag/{{params.tag_name}}.

Arguments:

Also retrieved by: "remove this label from the clickup space entirely", "get rid of a clickup tag for good", "wipe out a clickup marker we no longer use".

clickup.add_tag_to_task

Apply an existing tag to a ClickUp task. Use when the user wants to label, flag, or mark a ClickUp task with a tag that already exists. To make a new tag first use create_space_tag.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /task/{{params.task_id}}/tag/{{params.tag_name}}.

Arguments:

Also retrieved by: "flag this clickup ticket as urgent", "label this clickup to-do with the blocked marker", "put an existing clickup tag on this card".

clickup.remove_tag_from_task

Remove a tag from one ClickUp task without deleting the tag itself. Use when the user wants to untag, unflag, or unlabel a single ClickUp task.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls DELETE /task/{{params.task_id}}/tag/{{params.tag_name}}.

Arguments:

Also retrieved by: "unflag this clickup ticket", "take the urgent label off this clickup to-do", "clear a clickup marker from this card".