Clickup

Clickup Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Clickup MCP or direct API to create tasks, update statuses, manage projects, assign teammates, and automate workflows through natural language.

BOOK A CALL GET STARTED FOR FREE

ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place.

Supported Tools

Tools

Add dependencyAdds a 'waiting on' or 'blocking' dependency to a task, requiring either `depends on` (task becomes waiting on) or `dependency of` (task becomes blocking), but not both; `team id` is required if `custom task ids` is true.

Add guest to folderAdds a guest to a folder with specified permissions; requires a clickup enterprise plan.

Add guest to listShares a clickup list with an existing guest user, granting them specified permissions; requires the workspace to be on the clickup enterprise plan.

Add guest to taskAssigns a guest to a task with specified permissions; requires clickup enterprise plan, and `team id` if `custom task ids` is true.

Add tags from time entriesAssociates a list of specified tags with one or more time entries within a given team (workspace).

Add tag to taskAdds an existing tag to a specified task; team id is required if custom task ids is true.

Add task linkLinks two existing and accessible clickup tasks, identified by `task id` (source) and `links to` (target).

Add task to listAdds an existing task to an additional clickup list; the "tasks in multiple lists" clickapp must be enabled in the workspace for this.

Change tag names from time entriesUpdates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team id`.

Create a time entryCreates a new time entry for a specified team.

Create chat view commentPosts a new comment to a specified clickup chat view; the 'view id' must correspond to an existing and accessible chat view.

Create checklistCreates a new checklist with a specified name within an existing task, which can be identified by its standard id or a custom task id (if `custom task ids` is true, `team id` is also required).

Create checklist itemCreates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user.

Create folderCreates a new clickup folder within the specified space, which must exist and be accessible.

Create folderless listCreates a new folderless list (a list not part of any folder) directly within a specified clickup space.

Create folder viewCreates a new, highly customizable view within a specific clickup folder using its `folder id`.

Create goalCreates a new goal in a clickup team (workspace).

Create key resultCreates a new key result (target) for a specified goal in clickup to define and track measurable objectives towards achieving that goal.

Create listCreates a new list in clickup within a specified, existing folder.

Create list commentAdds a new comment with specific text to an existing and accessible clickup list, assigns it to a user, and sets notification preferences for all list members.

Create list viewCreates a new, customizable view (e.

Create spaceCreates a new space in a clickup team, with customizable name, privacy, color, and feature settings.

Create space tagCreates a new tag (name, foreground color, background color) in an existing clickup space.

Create space viewCreates a customizable view (e.

Create a taskCreates a new clickup task in a specific list, optionally as a subtask if a `parent` task id (which cannot be a subtask itself and must be in the same list) is provided.

Create task attachmentUploads a file as an attachment to a specified clickup task, requiring `multipart/form-data` for file upload.

Create task commentAdds a comment to a clickup task; `team id` is required if `custom task ids` is true.

Create task from templateCreates a new task in a specified clickup list from a task template, using the provided name for the new task.

Create teamCreates a new team (user group) with specified members in a workspace; member ids must be for existing users, and be aware that adding view-only guests as paid members may incur extra charges.

Create webhookCreates a clickup webhook for a team (workspace) to notify a public url on specified events (at least one, or '*' for all), optionally scoped to a space, folder, list, or task; the endpoint must accept requests from dynamic ips.

Create workspace Everything level viewCreates a new, customizable view (e.

Delete a time entryDeletes an existing time entry, specified by `timer id`, from a workspace identified by `team id`.

Delete checklistPermanently deletes an existing checklist identified by its `checklist id`.

Delete checklist itemPermanently deletes an existing item, identified by `checklist item id`, from an existing checklist, identified by `checklist id`.

Delete commentDeletes an existing comment from a task using its `comment id`.

Delete dependencyRemoves two dependency links for `task id`: one where `task id` is blocked by `depends on`, and another where `dependency of` is blocked by `task id`; `team id` is required if `custom task ids` is true.

Delete folderPermanently and irreversibly deletes a specified folder and all its contents (lists, tasks) if the folder id exists.

Delete goalPermanently removes an existing goal, identified by its `goal id`, from the workspace.

Delete key resultDeletes an existing key result, also referred to as a target within a goal, identified by its `key result id`.

Delete listPermanently deletes an existing list and all its contents; this action is destructive and irreversible via the api.

Delete spacePermanently deletes a specified space in clickup; this action is irreversible as the space cannot be recovered via the api.

Delete space tagDeletes a tag from a space, identified by `tag name` in path; precise matching of tag details in the request body (`tag name 1`, `tag tag fg`, `tag tag bg`) is generally required for successful deletion.

Delete taskPermanently deletes a task, using its standard id or a custom task id (requires `custom task ids=true` and `team id`).

Delete task linkDeletes an existing link, effectively a dependency or relationship, between two clickup tasks; set `custom task ids=true` and provide `team id` if using custom task ids.

Delete teamPermanently deletes an existing team (user group) from the workspace using its `group id`.

Delete time trackedDeletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.

Delete viewPermanently and irreversibly deletes an existing view in clickup, identified by its `view id`.

Delete webhookPermanently removes an existing webhook, specified by its id, thereby ceasing all its event monitoring and notifications.

Edit checklistUpdates an existing checklist's name or position, identified by its `checklist id`.

Edit checklist itemUpdates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting.

Edit guest on workspaceModifies the details and permissions of an existing guest user within a specific workspace.

Edit key resultUpdates an existing key result's progress or note in clickup, where the key result measures progress towards a goal.

Edit space tagUpdates an existing tag's name and colors in a clickup space; requires current tag name for identification, and new values for tag name, foreground color, and background color, all of which are mandatory for the update.

Edit time trackedEdits a legacy time-tracked interval for a task (identified by `task id` and `interval id`) to update its start/end times and duration; `team id` is required if `custom task ids` is true.

Edit user on workspaceUpdates a user's username, admin status, or custom role in a workspace; requires the workspace to be on an enterprise plan.

Get accessible custom fieldsRetrieves all accessible custom field definitions for a specified clickup list using its `list id`.

Get access tokenExchanges a clickup oauth 2.

Get all tags from time entriesRetrieves all unique tags applied to time entries within a specified clickup team (workspace).

Get authorized teams workspacesRetrieves a list of workspaces (teams) the authenticated user can access.

Get authorized userRetrieves the details of the currently authenticated clickup user.

Get bulk tasks time in statusRetrieves the time spent in each status for multiple tasks; requires the 'total time in status' clickapp to be enabled in the workspace.

Get chat view commentsRetrieves comments from a specified chat view in clickup, supporting pagination via `start` and `start id` to fetch comments older than the default 25 most recent.

Get custom rolesRetrieves all custom roles, which allow granular permission configurations, for a specified workspace (team).

Get custom task typesRetrieves all custom task types available within a specified workspace (team id).

Get filtered team tasksRetrieves a paginated list of tasks (up to 100 per page) from a specified team (workspace id in `team id`) based on various filter criteria, respecting user access permissions.

Get folderRetrieves detailed information about a specific folder in clickup.

Get folderless listsRetrieves all lists within a specified space that are not located in any folder.

Get foldersRetrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.

Get folder viewsRetrieves all configured views (like list, board, calendar) for a specified, existing folder in clickup.

Get goalRetrieves detailed information for an existing clickup goal, specified by its unique `goal id`.

Get goalsRetrieves goals for a specified clickup workspace (team); the `team id` must be valid and accessible.

Get guestCall this to retrieve detailed information for a specific guest within a team (workspace), ensuring the `guest id` is valid for the given `team id`; this action requires the clickup enterprise plan.

Get listRetrieves detailed information for an existing list in clickup, identified by its unique `list id`.

Get list commentsRetrieves comments for a specific clickup list, supporting pagination using `start` (timestamp) and `start id` (comment id) to fetch earlier comments; omits them for the latest 25.

Get list membersRetrieves all members of a specific, existing clickup list by its id.

Get listsRetrieves all lists within a specified, existing clickup folder, optionally filtering by archived status.

Get list viewsRetrieves all task and page views for a specified and accessible clickup list.

Get running time entryRetrieves the currently active time entry for a user in a workspace; a negative 'duration' in its data indicates it's running, and the response may be empty if no entry is active.

Get singular time entryFetches a specific time entry by its id for a given team; a negative duration in the response indicates an active timer.

Get spaceRetrieves detailed information for an existing space in a clickup workspace, identified by its unique space id.

Get spacesRetrieves spaces for a team id; member information for private spaces is returned only if the authenticated user is a member.

Get space tagsRetrieves all tags for tasks within a specified clickup space, requiring a valid `space id`.

Get space viewsRetrieves all task and page views for a specified space id in clickup.

Get taskRetrieves comprehensive details for a clickup task by its id, supporting standard or custom task ids (requires `team id` for custom ids).

Get task commentsRetrieves up to 25 comments for a specified task, supporting pagination using `start` and `start id` to fetch older comments.

Get task membersRetrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions.

Get tasksRetrieves tasks from a specified clickup list; only tasks whose home is the given list id are returned.

Get task s time in statusRetrieves the duration a task has spent in each status, provided the 'total time in status' clickapp is enabled for the workspace.

Get task templatesRetrieves task templates for a specified workspace (team id), supporting pagination.

Get teamsRetrieves user groups (teams) from a clickup workspace, typically requiring `team id` (workspace id), with an option to filter by `group ids`.

Get time entries within a date rangeRetrieves time entries for a specified team (workspace id) within a date range (defaults to the last 30 days for the authenticated user if dates are omitted); active timers are indicated by negative durations in the response.

Get time entry historyRetrieves the modification history for an existing time entry within a specific clickup team (workspace).

Get tracked timeRetrieves tracked time for a task using a legacy endpoint; prefer newer time tracking api endpoints for managing time entries.

Get userRetrieves detailed information for a specific user within a clickup workspace (team), available only for workspaces on the clickup enterprise plan.

Get viewFetches details for a specific clickup view, identified by its `view id`, which must exist.

Get view tasksRetrieves all tasks visible in a specified clickup view, respecting its applied filters, sorting, and grouping.

Get webhooksFetches webhooks for a team (workspace), returning only those created by the authenticated user via api, for a `team id` they can access.

Get workspace everything level viewsRetrieves all task and page views at the 'everything level' (a comprehensive overview of all tasks across all spaces) for a specified clickup workspace.

Get workspace planRetrieves the details of the current subscription plan for a specified clickup workspace.

Get workspace seatsRetrieves seat utilization (used, total, available for members/guests) for a clickup workspace (team) id, which must be for an existing workspace.

Invite guest to workspaceInvites a guest by email to a clickup workspace (team) on an enterprise plan, setting initial permissions and optionally a custom role; further access configuration for specific items may require separate actions.

Invite user to workspaceInvites a user via email to a clickup workspace (team), optionally granting admin rights or a custom role; requires an enterprise plan for the workspace.

Remove custom field valueRemoves an existing value from a custom field on a specific task; this does not delete the custom field definition or its predefined options.

Remove guest from folderRevokes a guest's access to a specific clickup folder, optionally unsharing items explicitly shared with them within it; requires an enterprise plan.

Remove guest from listRevokes a guest's access to a specific list, provided the guest currently has access to this list and the workspace is on the clickup enterprise plan.

Remove guest from taskRevokes a guest's access to a specific task; only available for workspaces on the clickup enterprise plan.

Remove guest from workspacePermanently removes a guest from a specified workspace, revoking all their access; this destructive operation requires the workspace to be on the clickup enterprise plan.

Remove tag from taskRemoves a tag from a specified task by disassociating it (does not delete the tag from workspace), succeeding even if the tag is not on the task.

Remove tags from time entriesRemoves tags from specified time entries in a team, without deleting the tags from the workspace.

Remove task from listRemoves a task from an extra list (not its home list); the 'tasks in multiple lists' clickapp must be enabled.

Remove user from workspaceDeactivates a user from a specified clickup workspace, revoking their access (user can be reactivated later); requires the workspace to be on an enterprise plan.

Set custom field valueSets or updates a custom field's value for a task; the new value (with type-dependent structure, e.

Shared hierarchyRetrieves the hierarchy of tasks, lists, and folders shared with the authenticated user within an existing clickup team (workspace), identified by its `team id`.

Start a time entryStarts a new time entry (timer) in the specified team (workspace), optionally associating it with a task, adding a description, setting billable status, or applying tags (tags feature requires business plan or higher).

Stop a time entryStops the authenticated user's currently active time entry in the specified team (workspace), which requires an existing time entry to be running.

Track timeRecords a time entry for a task using clickup's legacy time tracking system; newer endpoints are generally recommended.

Update a time entryUpdates an existing clickup time entry; provide `start` and `end` times together, and include `team id` as a query param (request field `team id 1`) if `custom task ids` is true.

Update commentUpdates an existing task comment's text, assignee (who must be a valid workspace member), or resolution status, requiring a valid existing comment id.

Update folderUpdates the name of an existing folder in clickup.

Update goalUpdates attributes of an existing clickup goal, identified by its `goal id`.

Update listUpdates attributes of an existing clickup list, such as its name, content, due date, priority, assignee, or color status, identified by its `list id`.

Update spaceUpdates an existing clickup space, allowing modification of its name, color, privacy, and feature settings (clickapps).

Update taskUpdates attributes of an existing task; `team id` is required if `custom task ids` is true, use a single space (" ") for `description` to clear it, and provide at least one modifiable field.

Update teamUpdates an existing clickup user group (team) using its `group id`; note that adding a view-only guest as a paid member may incur charges.

Update viewUpdates an existing clickup view's settings such as name, type, grouping, or filters; ensure `parent id` and `parent type` define a valid hierarchy, and that specified field names (e.

Update webhookUpdates the endpoint url, monitored events, and status of an existing webhook, identified by its `webhook id`.

Why Use Composio?

AI Native Clickup Integration

Supports both Clickup MCP and direct API based integrations
Structured, LLM-friendly schemas for reliable tool execution
Rich coverage for reading, writing, and querying your Clickup data

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke Clickup access
Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

Tools are tuned using real error and success rates to improve reliability over time
Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

Fine-grained RBAC so you control which agents and users can access Clickup
Scoped, least privilege access to Clickup resources
Full audit trail of agent actions to support review and compliance

Connect Clickup MCP Tool with your Agent

Python

TypeScript

Install Composio

python

pip install composio claude-agent-sdk

Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python

from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url

Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python

import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Clickup tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Add a new tag to task 12345 in ClickUp')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())

Use the MCP server with your AI agent

Connect Clickup API Tool with your Agent

Python

TypeScript

Install Composio

python

pip install composio_openai

Install the Composio SDK

Initialize Composio and Create Tool Router Session

python

from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')

Import and initialize Composio client, then create a Tool Router session

Execute Clickup Tools via Tool Router with Your Agent

python

tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Add a guest to the marketing folder with read-only permissions.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)

Get tools from Tool Router session and execute Clickup actions with your Agent

Use Clickup with any AI Agent Framework

Choose a Framework you want to connect Clickup with

OpenAI Agents SDK

Use Clickup MCP with OpenAI Agents SDK

Claude Agents SDK

Use Clickup MCP with Claude Agents SDK

Google ADK

Use Clickup MCP with Google ADK

Langchain

Use Clickup MCP with Langchain

AI SDK

Use Clickup MCP with AI SDK

Mastra AI

Use Clickup MCP with Mastra AI

LlamaIndex

Use Clickup MCP with LlamaIndex

CrewAI

Use Clickup MCP with CrewAI

Pydantic AI

Use Clickup MCP with Pydantic AI

Autogen

Use Clickup MCP with Autogen

Explore Other Toolkits

Agiled

API Key

Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place.

Ascora

API Key

Ascora is a cloud-based field service management platform for service businesses. It streamlines scheduling, invoicing, and customer operations in one place.

Canny

API Key

Canny is a platform for managing customer feedback and feature requests. It helps teams prioritize product decisions based on real user insights.

TOOLKIT MARKETPLACE

Frequently Asked Questions

Do I need my own developer credentials to use Clickup with Composio?

No, you can get started immediately using Composio's built-in Clickup app. For production, we recommend configuring your own OAuth credentials.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free

Harsha GaddipatiCo-founder, Slashy

Karan skipped his own birthday party to fix our critical issue. It was 10 pm and he diverted his Waymo to help us instead. This really sets the bar, shows you the commitment you need to have when users rely on your software.

Abhi AryaCo-founder, Opennote

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it has immensely helped in keeping new users on the platform.

Nirman DaveCEO, Zams

We chose Composio over Pipedream because it delivered depth where it mattered. It supported niche tools and tricky edge cases that other platforms simply ignored. Giving us confidence to scale without compromising.

Ryan YuFounder, Extra Thursday

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down in the complexities of managing agent auth would have been a death sentence for Extra Thursday.

Tomisin JenrolaFounder & CEO, SwarmZero

Before partnering with Composio, adding tool integrations was a slow, resource-intensive process. Each integration could take weeks or months of engineering time, and maintaining them meant constantly keeping up with API changes.

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.