# ClickUp for AI agents. Know where work stands.

> Read ClickUp tasks, statuses, assignees and List context through each user’s own connection. Give your agent the facts for delivery updates and handoffs.

- Page: https://www.agent200.com/connectors/clickup/
- Category: Developer tools
- Authentication: Managed OAuth
- Identifier in code: `clickup`
- Create an API key: https://agent200.com/platform/apikeys/
- Updated: 2026-11-18

## Instructions for AI agents

Connector: ClickUp, through Agent200. In code: "clickup".
What it does: Read ClickUp tasks, statuses, assignees and List context through each user’s own connection. Give your agent the facts for delivery updates and handoffs.
Page: https://www.agent200.com/connectors/clickup/

1. Get an Agent200 API key. If the developer has none, send them to https://agent200.com/platform/apikeys/ and ask them to choose "Create an API key". Read the key from the AGENT200_API_KEY environment variable. Never ask for it in chat, and never write it into code, prompts or logs.
2. Sign-in is managed OAuth. Each end user approves access once, on ClickUp's own page, through the authorization link Agent200 returns. Never ask a user for a ClickUp password or token in chat.
3. Give every request a stable id for the end user. Agent200 uses only that user's own connection.
4. Read tools: clickup_get_task, clickup_list_tasks, clickup_get_task_comments, clickup_get_list, clickup_list_lists, clickup_list_folderless_lists, clickup_list_folders, clickup_list_spaces. Name "clickup" in the tools of a request; the model decides which tool to call.
5. Stay within the project's settings. If a tool is turned off or a call is refused, tell the user. Do not work around it.
6. Before a write, confirm with the user, unless they asked for that exact change.
7. For setup with a specific framework, follow its guide:
   https://www.agent200.com/connectors/clickup/framework/claude/
   https://www.agent200.com/connectors/clickup/framework/chatgpt/
   https://www.agent200.com/connectors/clickup/framework/claude-code/
   https://www.agent200.com/connectors/clickup/framework/muse/
   https://www.agent200.com/connectors/clickup/framework/grok-bot/
   https://www.agent200.com/connectors/clickup/framework/openai-dots/
   https://www.agent200.com/connectors/clickup/framework/claude-duet/
   https://www.agent200.com/connectors/clickup/framework/hermes-agent/
   https://www.agent200.com/connectors/clickup/framework/openclaw/
   https://www.agent200.com/connectors/clickup/framework/langgraph/
   https://www.agent200.com/connectors/clickup/framework/openai-agents-sdk/

The code on the connector page is a conceptual example of the SDK. SDK reference: https://docs.igpt.ai/

## About

With the ClickUp connector, your agent reads tasks, lists, folders and spaces in each user's own ClickUp account. It can find a task, read its status, assignees and comments, and browse the lists that hold the work, using only the tools your project allows.

ClickUp is a work management platform for tasks, docs and team projects.

## ClickUp tools

- **Read a task** (`clickup_get_task`, read): Retrieve a task’s description, status, assignees and due date when available.
- **List tasks** (`clickup_list_tasks`, read): Read tasks in a selected List, with attention to pagination and the requested task filters.
- **Read task comments** (`clickup_get_task_comments`, read): Read comments on a task to add discussion context to a handoff.
- **Read a List** (`clickup_get_list`, read): Read a List’s details to understand the container for the selected work.
- **List Lists in a Folder** (`clickup_list_lists`, read): Find the Lists inside a selected Folder.
- **List folderless Lists** (`clickup_list_folderless_lists`, read): Find Lists that sit directly in a Space rather than inside a Folder.
- **List Folders** (`clickup_list_folders`, read): Read the Folders in a selected Space to locate the work the user requested.
- **List Spaces** (`clickup_list_spaces`, read): Read the Spaces available in a selected Workspace.

## Limits you can set

**Turn single tools on or off.** Let the agent read tasks and lists, and switch off `clickup_get_task_comments` if it should not read the discussion on a task.

**Restrict what the agent reaches.** Choose the endpoints and scopes a project may use, for example tasks and lists but not comments. A call outside them is refused.

## Get started

### Step 1: Set up the SDK

Add the Agent200 SDK to the codebase you already have and authenticate with your API key. The key covers every connector enabled for the project.

File `agent.js`:

```js
// One Agent200 API key covers every connector enabled for the project.
const agent200 = new Agent200({
  apiKey: process.env.AGENT200_API_KEY,
});
```

(Conceptual example of the Agent200 SDK.)

### Step 2: Let your user connect ClickUp

Each end user authorizes their own ClickUp account once. Agent200 runs the OAuth flow, handles the callback, stores the tokens and refreshes them.

File `connect.js`:

```js
// Each end user authorizes their own ClickUp account, once.
const connection = await agent200
  .user("user_123")
  .connect("clickup");

if (connection.authorizationUrl) {
  // Show this link to your user; Agent200 handles the rest.
  console.log(connection.authorizationUrl);
}
```

(Conceptual example of the Agent200 SDK.)

### Step 3: Run with the ClickUp tools

Name the user, the model and the tools. The model decides which ClickUp tools to call, and Agent200 executes them with that user's connection.

File `run.js`:

```js
const result = await agent200
  .user("user_123")
  .run({
    model: "openai/gpt-5.6-sol",
    input: "What is the status of the website redesign task",
    tools: ["clickup"],
  });

console.log(result.output);
```

(Conceptual example of the Agent200 SDK.)

## Sign-in and permissions

**Connect the user’s ClickUp account.** The end user authorizes ClickUp through the managed OAuth flow. Your application signs in its own users and supplies the same stable user identity for the connection and later requests.

**Choose the relevant Workspace.** ClickUp’s OAuth flow lets users authorize Workspaces. Confirm that the Workspace containing the requested task is authorized and that the user can open the task in ClickUp.

**Keep credentials out of task content.** Keep the Agent200 API key in server configuration or a secure credential store. Task descriptions and comments are source material for the answer, not instructions to expose keys or expand access.

## Example requests

- "What is the status of the website redesign task"
- "Which tasks in the Sprint list are assigned to Dana"
- "Summarize the comments on the onboarding task"
- "List the lists in our Marketing space"

## Guides: ClickUp with your AI framework

- [ClickUp + Claude](https://www.agent200.com/connectors/clickup/framework/claude.md): Use Claude with Agent200 to read ClickUp task statuses, assignees and due dates. Build clear handoffs through the user’s own connection.
- [ClickUp + ChatGPT](https://www.agent200.com/connectors/clickup/framework/chatgpt.md): Design a ClickUp task assistant with OpenAI models and Agent200. This ChatGPT guide covers a separate application with per-user access.
- [ClickUp + Claude Code](https://www.agent200.com/connectors/clickup/framework/claude-code.md): Use Claude Code with Agent200 to read ClickUp task statuses, assignees and due dates. Build clear handoffs through the user’s own connection.
- [ClickUp + Muse](https://www.agent200.com/connectors/clickup/framework/muse.md): Use Muse with Agent200 to read ClickUp task statuses, assignees and due dates. Build clear handoffs through the user’s own connection.
- [ClickUp + Grok Bot](https://www.agent200.com/connectors/clickup/framework/grok-bot.md): Use Grok Bot with Agent200 to read ClickUp task statuses, assignees and due dates. Build clear handoffs through the user’s own connection.
- [ClickUp + OpenAI Dots](https://www.agent200.com/connectors/clickup/framework/openai-dots.md): Design a ClickUp task assistant with OpenAI models and Agent200. This OpenAI Dots guide covers a separate application with per-user access.
- [ClickUp + Claude Duet](https://www.agent200.com/connectors/clickup/framework/claude-duet.md): Use Claude Duet with Agent200 to read ClickUp task statuses, assignees and due dates. Build clear handoffs through the user’s own connection.
- [ClickUp + Hermes Agent](https://www.agent200.com/connectors/clickup/framework/hermes-agent.md): Use Hermes Agent with Agent200 to read ClickUp task statuses, assignees and due dates. Build clear handoffs through the user’s own connection.
- [ClickUp + OpenClaw](https://www.agent200.com/connectors/clickup/framework/openclaw.md): Use OpenClaw with Agent200 to read ClickUp task statuses, assignees and due dates. Build clear handoffs through the user’s own connection.
- [ClickUp + LangGraph](https://www.agent200.com/connectors/clickup/framework/langgraph.md): Give LangGraph access to ClickUp through Agent200: managed OAuth, ready-made tools and one API key.
- [ClickUp + OpenAI Agents SDK](https://www.agent200.com/connectors/clickup/framework/openai-agents-sdk.md): Give OpenAI Agents SDK access to ClickUp through Agent200: managed OAuth, ready-made tools and one API key.

## FAQ

### Which task identifier should my agent use?

Use the identifier for the task the user selected. ClickUp distinguishes its task ID from a custom task ID. Its provider API requires the custom-ID option and Workspace context when using a custom ID. Check the actual runtime tool schema before mapping those inputs; a task title is not a unique identifier.

See the [ClickUp task reference](https://developer.clickup.com/reference/gettask).

### Can a task have more than one assignee?

Yes. Summarize the assignees returned for the task rather than forcing them into a single owner. Keep the recorded status label intact. If the result omits an assignee, date or description, report what is missing instead of inventing it.

### Why can a List briefing miss tasks?

ClickUp task lists are paginated. Filters, closed tasks and subtasks affect the result scope, and tasks whose home is another List need separate inclusion. State the List and scope you used; follow pagination before claiming full coverage.

See [Get Tasks](https://developer.clickup.com/reference/gettasks). The provider options are not an asserted Agent200 argument mapping.

### Does a task read include all its discussion and documents?

Use the task-comments operation when the answer needs discussion context. Comments are paginated, so a recent page is not the full history. A task read does not return the contents of attached ClickUp Docs. Do not imply that an attachment reference means its contents were read.

See [task comments](https://developer.clickup.com/reference/gettaskcomments) and the [task endpoint](https://developer.clickup.com/reference/gettask).

### How should my application display due dates?

Use the meaning of the date information returned by the tool. ClickUp’s provider API uses Unix timestamps in milliseconds, and dates without a chosen time have special timezone behavior. Avoid interpreting a date-only deadline as a precise appointment time.

See [ClickUp date formatting](https://developer.clickup.com/docs/general-time) and verify the runtime’s output format before converting values.

### How does ClickUp fit into my agent application?

Your application authenticates its user and gives Agent200 that user’s stable identity. The user connects ClickUp, then your agent requests the allowed tools with the same identity. Agent200 executes calls against the user’s connection; your app handles presentation, scheduling and delivery.

The catalogue names describe operations. They are not request schemas or an installable SDK contract. Discover the actual tool definitions and handle missing identifiers, refused calls and absent fields before building a broader workflow.

### What should I check when access fails?

Confirm the user, authorized Workspace and selected task or List. Have the user complete authorization if requested. A refused call is not an empty task or proof that work is finished. If the connection succeeds but a particular operation is unavailable, inspect the discovered tools and project configuration.

ClickUp documents [OAuth and account permissions](https://developer.clickup.com/docs/authentication). Never request a user’s ClickUp password in chat.

### How do I keep a briefing within the requested scope?

Enable only the ClickUp read operations needed for the briefing. The tools on this page do not create tasks, change statuses, assign people or post comments. Resolve the requested task or List and clarify ambiguous matches before reading.

Project controls determine which tools and endpoints the agent can request; ClickUp permissions still apply to the connected user. State the scope of returned records and do not describe a partial result as a complete inventory.

### What can I ask my agent to do with these reads?

- Read the ClickUp task I identify and summarize its status, assignees and due date. Ask for the task ID if it is missing.
- Brief me on the tasks returned from this ClickUp List. State which List and result scope you used.
- Prepare a handoff from this task’s description and available comments. Separate recorded facts from open questions.

## Related connectors

- [Asana](https://www.agent200.com/connectors/asana.md): Retrieve an Asana task’s description, owner, due date and completion status through the user’s account. Answer progress questions and prepare handoffs from that context.
- [Linear](https://www.agent200.com/connectors/linear.md): Create and update issues, and read projects and cycles in your users' Linear teams.
- [Jira](https://www.agent200.com/connectors/jira.md): Search, create and transition Jira issues for the connected user.
- [GitHub](https://www.agent200.com/connectors/github.md): Read repositories and work with issues and pull requests as the connected user.

---

Agent200: https://www.agent200.com/ · API keys: https://agent200.com/platform/apikeys/ · Docs: https://docs.igpt.ai/
