Start free
    Menu
    How it worksIntegrationsCustomersPricingSign in

    integrations tools clickup

    ClickUp MCP for your AI agent

    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.

    • 9readonly reads data.
    • 4writecreates or changes something.
    • 1destructivedeletes, 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. Plans, approvals and limits

    set it up.

    Add Cogny to your AI client once, then connect ClickUp in Cogny. Every ClickUp tool below appears in the client.

    • Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
    • Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
    • ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
    • CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
    • CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

    Full setup, and how to undo it

    Notes

    ClickUp connects with a single personal API token from ClickUp → Settings → Apps → API Token → Generate. The token is sent as the raw Authorization: <token> 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.

    what each tool does.

    Read 9 · only reads data

    • list_workspacesReadList the ClickUp workspaces ("teams") your API token can access.
    • list_spacesReadList the spaces inside a ClickUp workspace, by workspace id (from list_workspaces).
    • list_foldersReadList the folders inside a ClickUp space, by space id (from list_spaces).
    • list_listsReadList the lists in a folder (pass folder_id), or the folderless lists of a space (pass space_id instead).
    • list_tasksReadList the tasks on a ClickUp list, by list id (from list_lists).
    • list_workspace_tasksReadFilter tasks across every list of a workspace at once, by workspace id.
    • get_taskReadGet a single ClickUp task by its task id (from list_tasks), with its status, assignees, tags, dates and custom fields.
    • list_task_commentsReadList the comments on a ClickUp task, by task id (from list_tasks).
    • list_custom_fieldsReadList the custom fields available on a ClickUp list, by list id (from list_lists) — their ids, names and types, for use when creating tasks.

    Write 4 · creates or changes something

    • create_taskWriteCreate 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_taskWriteUpdate an existing ClickUp task, by task id (from list_tasks).
    • create_task_commentWriteAdd a comment to a ClickUp task, by task id (from list_tasks).
    • add_task_tagWriteAdd a tag to a ClickUp task, by task id (from list_tasks) and the tag name (from list_tasks' tags or list_custom_fields).

    Destructive 1 · deletes, removes or replaces something

    • remove_task_tagDestructiveRemove 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.

    This page as markdownAll integrations