# ClickUp tools in Cogny Cogny's ClickUp integration exposes 14 tools (9 read, 4 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app. - **Read** (9): only reads data. - **Write** (4): creates or changes something. - **Destructive** (1): deletes, removes or replaces something. Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. ## Notes ClickUp connects with a single personal API token from ClickUp → Settings → Apps → API Token → Generate. The token is sent as the raw `Authorization: ` header (no "Bearer" prefix) to api.clickup.com. It acts as the ClickUp user who generated it: it has that user's permissions and only reaches the workspaces that user is a member of, and never expires. Navigation is top-down, every id comes from the call above it: `list_workspaces` → workspace id → `list_spaces` → space id → `list_folders` and `list_lists` → list id → `list_tasks`. A space can hold lists "folderless" (no folder); pass `space_id` instead of `folder_id` to `list_lists` for those. Tasks are paginated 100 per page with a `page` index and a `last_page` flag. Due dates are millisecond epoch timestamps — ClickUp has no "days from now" shortcut. The ClickUp v2 API rate-limits by token (100 requests/minute on the free tier) and answers HTTP 429 with `X-RateLimit-*` headers when exhausted; the server surfaces that clearly. Creating a task (with assignees), updating a task (assignee or status changes) and commenting on a task can each notify the task's assignees and watchers at ClickUp, so these write tools require `confirm=true` and send nothing otherwise. ## Known gaps - No task deletion, and no permanent removal of any task — the connector creates and edits tasks but never deletes them. - No checklists, sub-tasks, time tracking, or dependencies. - Folders, lists, spaces and workspaces can't be created, renamed or removed from Cogny. - No way to move a task between lists. - Views and dashboards aren't exposed. ## All tools | Tool | Kind | What it does | |---|---|---| | `list_workspaces` | Read | List the ClickUp workspaces ("teams") your API token can access. | | `list_spaces` | Read | List the spaces inside a ClickUp workspace, by workspace id (from list_workspaces). | | `list_folders` | Read | List the folders inside a ClickUp space, by space id (from list_spaces). | | `list_lists` | Read | List the lists in a folder (pass folder_id), or the folderless lists of a space (pass space_id instead). | | `list_tasks` | Read | List the tasks on a ClickUp list, by list id (from list_lists). | | `list_workspace_tasks` | Read | Filter tasks across every list of a workspace at once, by workspace id. | | `get_task` | Read | Get a single ClickUp task by its task id (from list_tasks), with its status, assignees, tags, dates and custom fields. | | `list_task_comments` | Read | List the comments on a ClickUp task, by task id (from list_tasks). | | `list_custom_fields` | Read | List the custom fields available on a ClickUp list, by list id (from list_lists) — their ids, names and types, for use when creating tasks. | | `create_task` | Write | Create a new task in a ClickUp list, by list id (from list_lists). priority is 1 (urgent) to 4 (low); due_date is a millisecond epoch timestamp. | | `update_task` | Write | Update an existing ClickUp task, by task id (from list_tasks). | | `create_task_comment` | Write | Add a comment to a ClickUp task, by task id (from list_tasks). | | `add_task_tag` | Write | Add a tag to a ClickUp task, by task id (from list_tasks) and the tag name (from list_tasks' tags or list_custom_fields). | | `remove_task_tag` | Destructive | Remove a tag from a ClickUp task, by task id (from list_tasks) and the tag name (add it back later with add_task_tag). | Exact input schemas come from `tools/list` once ClickUp is connected; the free plan is enough to check. Missing something? Your agent can ask for it with `request_feature`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt