How to integrate Clickup MCP with Vercel AI SDK v6

This guide walks you through connecting Clickup to Vercel AI SDK v6 using the Composio tool router. By the end, you'll have a working Clickup agent that can add 'urgent' tag to today's tasks, create a time entry for design work, share project folder with new guest user through natural language commands. This guide will help you understand how to give your Vercel AI SDK agent real control over a Clickup account through Composio's Clickup MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved.

Get started for freeGet a demo
Clickup logoClickup
Oauth2Api Key

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.

162 Tools

Introduction

This guide walks you through connecting Clickup to Vercel AI SDK v6 using the Composio tool router. By the end, you'll have a working Clickup agent that can add 'urgent' tag to today's tasks, create a time entry for design work, share project folder with new guest user through natural language commands.

This guide will help you understand how to give your Vercel AI SDK agent real control over a Clickup account through Composio's Clickup MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Clickup with

ChatGPTOpenAI Agents SDKClaude Agent SDKClaude CodeClaude CoworkCodexOpenCodeCursorVS CodeOpenClawHermesCLIGoogle ADKLangChainMastra AILlamaIndexCrewAI

TL;DR

Here's what you'll learn:
  • How to set up and configure a Vercel AI SDK agent with Clickup integration
  • Using Composio's Tool Router to dynamically load and access Clickup tools
  • Creating an MCP client connection using HTTP transport
  • Building an interactive CLI chat interface with conversation history management
  • Handling tool calls and results within the Vercel AI SDK framework

What is Vercel AI SDK?

The Vercel AI SDK is a TypeScript library for building AI-powered applications. It provides tools for creating agents that can use external services and maintain conversation state.

Key features include:

  • streamText: Core function for streaming responses with real-time tool support
  • MCP Client: Built-in support for Model Context Protocol via @ai-sdk/mcp
  • Step Counting: Control multi-step tool execution with stopWhen: stepCountIs()
  • OpenAI Provider: Native integration with OpenAI models

What is the Clickup MCP server, and what's possible with it?

The Clickup MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your ClickUp account. It provides structured and secure access to your projects, tasks, and team collaboration features, so your agent can manage tasks, add dependencies, assign guests, tag work, and streamline workflows on your behalf.

  • Automated task management: Easily have your agent create new time entries, add tasks to multiple lists, or link related tasks to keep your projects organized and up to date.
  • Dependency tracking and updates: Instruct your agent to set up 'waiting on' or 'blocking' dependencies between tasks, ensuring everything flows smoothly and work bottlenecks are visible and managed automatically.
  • Seamless guest access: Let your agent add guests to folders, lists, or individual tasks with specific permissions, helping external collaborators get the right level of access instantly.
  • Tagging and time entry management: Direct your agent to add or update tags on time entries, or manage tags for specific tasks, enabling better tracking and reporting for your team's efforts.
  • Task and list organization: Have your agent quickly add existing tasks to additional lists or update key task attributes, so you can adapt to new priorities without manual effort.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before you begin, make sure you have:
  • Node.js and npm installed
  • A Composio account with API key
  • An OpenAI API key
2

Getting API Keys for OpenAI and Composio

OpenAI API Key
  • Go to the OpenAI dashboard and create an API key. You'll need credits to use the models, or you can connect to another model provider.
  • Keep the API key safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Navigate to your API settings and generate a new API key.
  • Store this key securely as you'll need it for authentication.
3

Install required dependencies

bash
npm install @ai-sdk/openai @ai-sdk/mcp @composio/core ai dotenv

First, install the necessary packages for your project.

What you're installing:

  • @ai-sdk/openai: Vercel AI SDK's OpenAI provider
  • @ai-sdk/mcp: MCP client for Vercel AI SDK
  • @composio/core: Composio SDK for tool integration
  • ai: Core Vercel AI SDK
  • dotenv: Environment variable management
4

Set up environment variables

bash
OPENAI_API_KEY=your_openai_api_key_here
COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_user_id_here

Create a .env file in your project root.

What's needed:

  • OPENAI_API_KEY: Your OpenAI API key for GPT model access
  • COMPOSIO_API_KEY: Your Composio API key for tool access
  • COMPOSIO_USER_ID: A unique identifier for the user session
5

Import required modules and validate environment

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Composio } from "@composio/core";
import * as readline from "readline";
import { streamText, type ModelMessage, stepCountIs } from "ai";
import { createMCPClient } from "@ai-sdk/mcp";

const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!process.env.OPENAI_API_KEY) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey,
});
What's happening:
  • We're importing all necessary libraries including Vercel AI SDK's OpenAI provider and Composio
  • The dotenv/config import automatically loads environment variables
  • The MCP client import enables connection to Composio's tool server
6

Create Tool Router session and initialize MCP client

typescript
async function main() {
  // Create a tool router session for the user
  const session = await composio.create(composioUserID!, {
    toolkits: ["clickup"],
  });

  const mcpUrl = session.mcp.url;
What's happening:
  • We're creating a Tool Router session that gives your agent access to Clickup tools
  • The create method takes the user ID and specifies which toolkits should be available
  • The returned mcp object contains the URL and authentication headers needed to connect to the MCP server
  • This session provides access to all Clickup-related tools through the MCP protocol
7

Connect to MCP server and retrieve tools

typescript
const mcpClient = await createMCPClient({
  transport: {
    type: "http",
    url: mcpUrl,
    headers: session.mcp.headers, // Authentication headers for the Composio MCP server
  },
});

const tools = await mcpClient.tools();
What's happening:
  • We're creating an MCP client that connects to our Composio Tool Router session via HTTP
  • The mcp.url provides the endpoint, and mcp.headers contains authentication credentials
  • The type: "http" is important - Composio requires HTTP transport
  • tools() retrieves all available Clickup tools that the agent can use
8

Initialize conversation and CLI interface

typescript
let messages: ModelMessage[] = [];

console.log("Chat started! Type 'exit' or 'quit' to end the conversation.\n");
console.log(
  "Ask any questions related to clickup, like summarize my last 5 emails, send an email, etc... :)))\n",
);

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: "> ",
});

rl.prompt();
What's happening:
  • We initialize an empty messages array to maintain conversation history
  • A readline interface is created to accept user input from the command line
  • Instructions are displayed to guide the user on how to interact with the agent
9

Handle user input and stream responses with real-time tool feedback

typescript
rl.on("line", async (userInput: string) => {
  const trimmedInput = userInput.trim();

  if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
    console.log("\nGoodbye!");
    rl.close();
    process.exit(0);
  }

  if (!trimmedInput) {
    rl.prompt();
    return;
  }

  messages.push({ role: "user", content: trimmedInput });
  console.log("\nAgent is thinking...\n");

  try {
    const stream = streamText({
      model: openai("gpt-5"),
      messages,
      tools,
      toolChoice: "auto",
      stopWhen: stepCountIs(10),
      onStepFinish: (step) => {
        for (const toolCall of step.toolCalls) {
          console.log(`[Using tool: ${toolCall.toolName}]`);
          }
          if (step.toolCalls.length > 0) {
            console.log(""); // Add space after tool calls
          }
        },
      });

      for await (const chunk of stream.textStream) {
        process.stdout.write(chunk);
      }

      console.log("\n\n---\n");

      // Get final result for message history
      const response = await stream.response;
      if (response?.messages?.length) {
        messages.push(...response.messages);
      }
    } catch (error) {
      console.error("\nAn error occurred while talking to the agent:");
      console.error(error);
      console.log(
        "\nYou can try again or restart the app if it keeps happening.\n",
      );
    } finally {
      rl.prompt();
    }
  });

  rl.on("close", async () => {
    await mcpClient.close();
    console.log("\n👋 Session ended.");
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});
What's happening:
  • We use streamText instead of generateText to stream responses in real-time
  • toolChoice: "auto" allows the model to decide when to use Clickup tools
  • stopWhen: stepCountIs(10) allows up to 10 steps for complex multi-tool operations
  • onStepFinish callback displays which tools are being used in real-time
  • We iterate through the text stream to create a typewriter effect as the agent responds
  • The complete response is added to conversation history to maintain context
  • Errors are caught and displayed with helpful retry suggestions

Complete Code

Here's the complete code to get you started with Clickup and Vercel AI SDK:

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Composio } from "@composio/core";
import * as readline from "readline";
import { streamText, type ModelMessage, stepCountIs } from "ai";
import { createMCPClient } from "@ai-sdk/mcp";

const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!process.env.OPENAI_API_KEY) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey,
});

async function main() {
  // Create a tool router session for the user
  const session = await composio.create(composioUserID!, {
    toolkits: ["clickup"],
  });

  const mcpUrl = session.mcp.url;

  const mcpClient = await createMCPClient({
    transport: {
      type: "http",
      url: mcpUrl,
      headers: session.mcp.headers, // Authentication headers for the Composio MCP server
    },
  });

  const tools = await mcpClient.tools();

  let messages: ModelMessage[] = [];

  console.log("Chat started! Type 'exit' or 'quit' to end the conversation.\n");
  console.log(
    "Ask any questions related to clickup, like summarize my last 5 emails, send an email, etc... :)))\n",
  );

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: "> ",
  });

  rl.prompt();

  rl.on("line", async (userInput: string) => {
    const trimmedInput = userInput.trim();

    if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
      console.log("\nGoodbye!");
      rl.close();
      process.exit(0);
    }

    if (!trimmedInput) {
      rl.prompt();
      return;
    }

    messages.push({ role: "user", content: trimmedInput });
    console.log("\nAgent is thinking...\n");

    try {
      const stream = streamText({
        model: openai("gpt-5"),
        messages,
        tools,
        toolChoice: "auto",
        stopWhen: stepCountIs(10),
        onStepFinish: (step) => {
          for (const toolCall of step.toolCalls) {
            console.log(`[Using tool: ${toolCall.toolName}]`);
          }
          if (step.toolCalls.length > 0) {
            console.log(""); // Add space after tool calls
          }
        },
      });

      for await (const chunk of stream.textStream) {
        process.stdout.write(chunk);
      }

      console.log("\n\n---\n");

      // Get final result for message history
      const response = await stream.response;
      if (response?.messages?.length) {
        messages.push(...response.messages);
      }
    } catch (error) {
      console.error("\nAn error occurred while talking to the agent:");
      console.error(error);
      console.log(
        "\nYou can try again or restart the app if it keeps happening.\n",
      );
    } finally {
      rl.prompt();
    }
  });

  rl.on("close", async () => {
    await mcpClient.close();
    console.log("\n👋 Session ended.");
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});

Conclusion

You've successfully built a Clickup agent using the Vercel AI SDK with streaming capabilities! This implementation provides a powerful foundation for building AI applications with natural language interfaces and real-time feedback.

Key features of this implementation:

  • Real-time streaming responses for a better user experience with typewriter effect
  • Live tool execution feedback showing which tools are being used as the agent works
  • Dynamic tool loading through Composio's Tool Router with secure authentication
  • Multi-step tool execution with configurable step limits (up to 10 steps)
  • Comprehensive error handling for robust agent execution
  • Conversation history maintenance for context-aware responses

You can extend this further by adding custom error handling, implementing specific business logic, or integrating additional Composio toolkits to create multi-app workflows.
TOOLS

Supported Tools

Every Clickup action and event your agent gets out of the box.

Add dependency

Adds 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 folder

Adds a guest to a folder with specified permissions; requires a ClickUp Enterprise Plan.

Add guest to list

Shares 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 task

Assigns 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 entries

Associates a list of specified tags with one or more time entries within a given Team (Workspace).

Add tag to task

Adds an existing tag to a specified task; team_id is required if custom_task_ids is true.

Add task link

Links two existing and accessible ClickUp tasks, identified by `task_id` (source) and `links_to` (target).

Add task to list

Adds an existing task to an additional ClickUp List; the "Tasks in Multiple Lists" ClickApp must be enabled in the Workspace for this.

Update Doc Page

Tool to update/edit a ClickUp Doc page's title and/or content via the v3 Docs API.

Create a time entry

Creates a new time entry for a specified team.

Create chat channel

Tool to create a chat channel in a ClickUp workspace.

Create chat message

Tool to send a message in a ClickUp chat channel.

Create chat reaction

Tool to add a reaction to a ClickUp chat message.

Create chat view comment

Posts a new comment to a specified ClickUp Chat view; the 'view_id' must correspond to an existing and accessible Chat view.

Create checklist

Creates 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 item

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

Create direct message channel

Tool to create a direct message channel in ClickUp.

Create Doc

Tool to create a new ClickUp Doc in a Workspace (v3 Docs API) and return the new doc_id for follow-up page/content operations.

Create Doc Page

Tool to create a page in a ClickUp Doc (v3 Docs API).

Create folder

Creates a new ClickUp Folder within the specified Space, which must exist and be accessible.

Create folderless list

Creates a new folderless list (a list not part of any Folder) directly within a specified ClickUp Space.

Create folder view

Creates a new, highly customizable view within a specific ClickUp folder using its `folder_id`.

Create goal

Creates a new goal in a ClickUp Team (Workspace).

Create key result

Creates a new Key Result (Target) for a specified Goal in ClickUp to define and track measurable objectives towards achieving that Goal.

Create list

Creates a new list in ClickUp within an existing folder.

Create list comment

Adds 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 from template in folder

Creates a new list from a template in a specified ClickUp folder.

Create list view

Creates a new, customizable view (e.

Create Location Chat Channel

Tool to create a Channel on a Space, Folder, or List in ClickUp.

Create reply message

Tool to create a reply to a chat message in ClickUp.

Create space

Creates a new ClickUp Space within a specified Workspace, allowing feature configuration which defaults to Workspace settings if unspecified.

Create space tag

Creates a new tag (name, foreground color, background color) in an existing ClickUp Space.

Create space view

Creates a customizable view (e.

Create a task

Creates 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 attachment

Uploads a file as an attachment to a specified ClickUp task using multipart/form-data.

Create task comment

Adds a comment to a ClickUp task; `team_id` is required if `custom_task_ids` is true.

Create task from template

Creates a new task in a specified ClickUp list from a task template, using the provided name for the new task.

Create team

Creates 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 threaded comment

Tool to create a threaded reply to a comment in ClickUp.

Create webhook

Creates 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 view

Creates a new, customizable view (e.

Delete chat channel

Tool to delete a chat channel in ClickUp.

Delete chat message

Tool to delete a chat message in ClickUp.

Delete chat reaction

Tool to delete a reaction from a chat message in ClickUp.

Delete checklist

Permanently deletes an existing checklist identified by its `checklist_id`.

Delete checklist item

Permanently deletes an existing item, identified by `checklist_item_id`, from an existing checklist, identified by `checklist_id`.

Delete comment

Deletes an existing comment from a task using its `comment_id`.

Delete dependency

Removes a dependency relationship for a task.

Delete folder

Permanently and irreversibly deletes a specified folder and all its contents (Lists, Tasks) if the folder_id exists.

Delete goal

Permanently removes an existing Goal, identified by its `goal_id`, from the Workspace.

Delete key result

Deletes an existing Key Result, also referred to as a Target within a Goal, identified by its `key_result_id`.

Delete list

Permanently deletes an existing List and all its contents; this action is destructive and irreversible via the API.

Delete space

Permanently deletes a specified Space in ClickUp; this action is irreversible as the Space cannot be recovered via the API.

Delete space tag

Deletes 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 task

Permanently deletes a task, using its standard ID or a custom task ID (requires `custom_task_ids=true` and `team_id`).

Delete task link

Deletes 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 team

Permanently deletes an existing Team (user group) from the Workspace using its `group_id`.

Delete a time entry

Deletes an existing time entry, specified by `timer_id`, from a Workspace identified by `team_id`.

Delete time tracked

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

Delete view

Permanently and irreversibly deletes an existing View in ClickUp, identified by its `view_id`.

Delete webhook

Permanently removes an existing webhook, specified by its ID, thereby ceasing all its event monitoring and notifications.

Get accessible custom fields

Retrieves all accessible Custom Field definitions for a specified ClickUp List using its `list_id`.

Get access token

Exchanges a ClickUp OAuth 2.

Get all tags from time entries

Retrieves all unique tags applied to time entries within a specified ClickUp Team (Workspace).

Get authorized teams workspaces

Retrieves a list of Workspaces (Teams) the authenticated user can access.

Get authorized user

Retrieves the details of the currently authenticated ClickUp user.

Get bulk tasks time in status

Retrieves the time spent in each status for multiple tasks; requires the 'Total time in Status' ClickApp to be enabled in the Workspace.

Get chat channel

Retrieves details for a specific chat channel in a ClickUp Workspace.

Get chat channel followers

Tool to retrieve followers of a ClickUp chat channel.

Get chat channel members

Tool to get members of a chat channel.

Get chat channels

Tool to retrieve chat channels in a ClickUp workspace.

Get chat message reactions

Tool to retrieve reactions on a ClickUp chat message.

Get chat message replies

Retrieves replies to a chat message in ClickUp.

Get chat messages

Tool to retrieve messages from a ClickUp chat channel.

Get chat message tagged users

Tool to retrieve users tagged in a ClickUp chat message.

Get chat view comments

Retrieves 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 roles

Retrieves all Custom Roles, which allow granular permission configurations, for a specified Workspace (Team).

Get custom task types

Retrieves all custom task types available within a specified Workspace (team_id).

Get Doc Content

Tool to fetch the full content of a ClickUp Doc including metadata and all page contents in markdown format.

Get Doc Page Content

Tool to fetch a single ClickUp Doc page's content and metadata by workspace_id + doc_id + page_id (v3 Docs API).

Get Doc Page Listing

Tool to fetch the page listing structure of a ClickUp Doc by workspace_id and doc_id.

Get Doc Pages

Tool to fetch pages belonging to a ClickUp Doc.

Get filtered team tasks

Retrieves a paginated list of tasks (up to 100 per page) from a specified workspace based on various filter criteria, respecting user access permissions.

Get folder

Retrieves detailed information about a specific folder in ClickUp.

Get Folder Available Fields

Tool to view custom fields available in a ClickUp folder.

Get folderless lists

Retrieves all Lists within a specified Space that are not located in any Folder.

Get folders

Retrieves Folders within a specified ClickUp Space, ensuring `space_id` is valid, with an option to filter by archived status.

Get folder views

Retrieves all configured views (like List, Board, Calendar) for a specified, existing Folder in ClickUp.

Get goal

Retrieves detailed information for an existing ClickUp Goal, specified by its unique `goal_id`.

Get goals

Retrieves goals for a specified ClickUp Workspace (Team); the `team_id` must be valid and accessible.

Get guest

Call 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 list

Retrieves detailed information for an existing List in ClickUp, identified by its unique `list_id`.

Get list comments

Retrieves 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 members

Retrieves all members of a specific, existing ClickUp List by its ID.

Get lists

Retrieves all lists within a specified, existing ClickUp folder, optionally filtering by archived status.

Get list views

Retrieves all task and page views for a specified and accessible ClickUp List.

Get running time entry

Retrieves 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.

Shared hierarchy

Retrieves the hierarchy of tasks, Lists, and Folders shared with the authenticated user within an existing ClickUp Team (Workspace), identified by its `team_id`.

Get space

Retrieves detailed information for an existing Space in a ClickUp Workspace, identified by its unique space_id.

Get space available fields

Retrieves all custom fields available in a ClickUp Space, identified by space_id.

Get spaces

Retrieves Spaces for a Team ID; member information for private Spaces is returned only if the authenticated user is a member.

Get space tags

Retrieves all tags for tasks within a specified ClickUp Space, requiring a valid `space_id`.

Get space views

Retrieves all task and page views for a specified Space ID in ClickUp.

Get post subtype IDs

Tool to retrieve post subtype IDs (Announcement, Discussion, Idea, Update) for a ClickUp Workspace.

Get task

Retrieves comprehensive details for a ClickUp task by its ID, supporting standard or custom task IDs (requires `team_id` for custom IDs).

Get task comments

Retrieves up to 25 comments for a specified task, supporting pagination using `start` and `start_id` to fetch older comments.

Get task members

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

Get tasks

Retrieves tasks from a specified ClickUp list; only tasks whose home is the given list_id are returned.

Get task templates

Retrieves task templates for a specified Workspace (Team ID), supporting pagination.

Get task s time in status

Retrieves the duration a task has spent in each status, provided the 'Total time in Status' ClickApp is enabled for the Workspace.

Get team available fields

Retrieves all custom fields available in a ClickUp Workspace (Team), identified by team_id.

Get teams

Retrieves user groups (Teams) from a ClickUp Workspace, typically requiring `team_id` (Workspace ID), with an option to filter by `group_ids`.

Get threaded comments

Retrieves threaded replies to a parent comment.

Get time entries within a date range

Retrieves 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 singular time entry

Fetches a specific time entry by its ID for a given team; a negative duration in the response indicates an active timer.

Get time entry history

Retrieves the modification history for an existing time entry within a specific ClickUp Team (Workspace).

Get tracked time

Retrieves tracked time for a task using a legacy endpoint; prefer newer Time Tracking API endpoints for managing time entries.

Get user

Retrieves detailed information for a specific user within a ClickUp Workspace (Team), available only for Workspaces on the ClickUp Enterprise Plan.

Get view

Fetches details for a specific ClickUp view, identified by its `view_id`, which must exist.

Get view tasks

Retrieves all tasks visible in a specified ClickUp view, respecting its applied filters, sorting, and grouping.

Get webhooks

Fetches 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 views

Retrieves 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 plan

Retrieves the details of the current subscription plan for a specified ClickUp Workspace.

Get workspace seats

Retrieves seat utilization (used, total, available for members/guests) for a ClickUp Workspace (Team) ID, which must be for an existing Workspace.

Invite guest to workspace

Invites 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 workspace

Invites a user via email to a ClickUp Workspace (Team), optionally granting admin rights or a custom role; requires an Enterprise Plan for the Workspace.

Move task to new home list

Tool to move a task to a new home List using ClickUp Public API v3.

Remove custom field value

Removes 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 folder

Revokes 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 list

Revokes 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 task

Revokes a guest's access to a specific task; only available for Workspaces on the ClickUp Enterprise Plan.

Remove guest from workspace

Permanently 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 task

Removes 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 entries

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

Remove task from list

Removes a task from an extra list (not its home list); the 'Tasks in Multiple Lists' ClickApp must be enabled.

Remove user from workspace

Deactivates a user from a specified ClickUp Workspace, revoking their access (user can be reactivated later); requires the Workspace to be on an Enterprise Plan.

Search Docs

Tool to search and list Docs metadata in a ClickUp workspace.

Set custom field value

Sets or updates a Custom Field's value for a task; the new value (with type-dependent structure, e.

Start a time entry

Starts 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 entry

Stops the authenticated user's currently active time entry in the specified Team (Workspace), which requires an existing time entry to be running.

Track time

Records a time entry for a task using ClickUp's legacy time tracking system; newer endpoints are generally recommended.

Update chat channel

Tool to update a ClickUp chat channel's properties including name, topic, description, visibility, and location.

Update chat message

Tool to update a ClickUp chat message's content, assignee, or resolved status via the v3 API.

Edit checklist

Updates an existing checklist's name or position, identified by its `checklist_id`.

Edit checklist item

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

Update comment

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

Update folder

Updates the name of an existing folder in ClickUp.

Update goal

Updates attributes of an existing ClickUp goal, identified by its `goal_id`.

Edit guest on workspace

Modifies the details and permissions of an existing guest user within a specific Workspace.

Edit key result

Updates an existing key result's progress or note in ClickUp, where the key result measures progress towards a goal.

Update list

Updates attributes of an existing ClickUp list, such as its name, content, due date, priority, assignee, or color status, identified by its `list_id`.

Update space

Updates an existing ClickUp Space, allowing modification of its name, color, privacy, and feature settings (ClickApps).

Edit space tag

Updates 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.

Update task

Updates 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 team

Updates 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 a time entry

Updates an existing ClickUp time entry.

Change tag names from time entries

Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team_id`.

Edit time tracked

Edits 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 workspace

Updates a user's username, admin status, or custom role in a Workspace; requires the Workspace to be on an Enterprise Plan.

Update view

Updates 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 webhook

Updates the endpoint URL, monitored events, and status of an existing webhook, identified by its `webhook_id`.

Update workspace ACL

Updates privacy and access control list (ACL) permissions for a workspace object or location.

FRAMEWORKS

How to build Clickup MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Clickup MCP with ChatGPT

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Clickup MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Clickup MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Clickup MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Clickup MCP with Claude Cowork

Codex logo

Codex

Use Clickup MCP with Codex

Cursor logo

Cursor

Use Clickup MCP with Cursor

OpenClaw logo

OpenClaw

Use Clickup MCP with OpenClaw

Hermes logo

Hermes

Use Clickup MCP with Hermes

CLI logo

CLI

Use Clickup MCP with CLI

Google ADK logo

Google ADK

Use Clickup MCP with Google ADK

LangChain logo

LangChain

Use Clickup MCP with LangChain

Mastra AI logo

Mastra AI

Use Clickup MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Clickup MCP with LlamaIndex

CrewAI logo

CrewAI

Use Clickup MCP with CrewAI

OpenCode logo

OpenCode

Use Clickup MCP with OpenCode

VS Code logo

VS Code

Use Clickup MCP with VS Code

FAQ

Frequently asked questions

With a standalone Clickup MCP server, the agents and LLMs can only access a fixed set of Clickup tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Clickup and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Vercel AI SDK v6 fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Clickup tools.

Yes, absolutely. You can configure which Clickup scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Clickup data and credentials are handled as safely as possible.

Start with Clickup.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Clickup tool your agent needs.Free to start.

Start building
Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREEBOOK A DEMO
agent.aiZoomLettaGleanHubSpotAWSWabi

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

Harsha Gaddipati
Harsha Gaddipati
Co-founder, Slashy

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's immensely helped keep new users on the platform.

Abhi Arya
Abhi Arya
Co-founder, Opennote

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

Nirman Dave
Nirman Dave
CEO, Zams

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

Ryan Yu
Ryan Yu
Founder, Extra Thursday

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

Tomisin Jenrola
Tomisin Jenrola
Founder & CEO, SwarmZero

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.

Jerome Leclanche
Jerome Leclanche
Co-Founder, Ingram Technologies