# ClickUp MCP for AI Agents AI Agent Connect

> ClickUp MCP connects your project management platform to your AI agent. You can create tasks, check list statuses, and browse workspaces using plain English. It lets your agent see your project hierarchy so you don't have to keep switching tabs between your chat and your dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OV9Pp6773p5tqDzZDycxGm1ygnTN0gDPsCi8vJAb/ai-agent-connect
- **Tags:** task-tracking, workflow-automation, hierarchy-management, team-collaboration, goal-setting, time-tracking

## Description

ClickUp is where your team's work actually happens, but digging through nested folders and endless lists can feel like a chore. This Connector changes that by giving your AI agent a direct line into your project management environment. Instead of manually navigating menus or copy-pasting status updates, you can just tell your agent what needs to get done. It handles the heavy lifting of looking up task details, listing workspace contents, and organizing your to-do list. Since Vinkius hosts this Connector, you can jump straight from your chat interface into your production pipeline. It's about moving from "where is that task?" to "get that done" without the friction of a traditional dashboard. You can check your own profile info or see every workspace you belong to with a single command. This means you spend less time hunting for information and more time actually finishing your work. It turns your project management tool into an active participant in your daily workflow.

## Tools

### list_lists
Lists contain the actual tasks.

List all Lists in a Folder

### list_spaces
Spaces are large groupings of folders and lists.

List all Spaces in a Workspace

### list_tasks
Supports pagination to handle large numbers of tasks.

List tasks within a List

### list_workspaces
Workspaces are the top-level unit in ClickUp.

List all ClickUp Workspaces

### update_task
Can update the name, description, or status.

Update an existing task

### create_task
Requires a task name. Optional status and description can be provided.

Create a new task in a List

### delete_task
Delete a specific task

### get_task_details
This tool gets detailed information for a specific task. It lets you pull descriptions and due dates into your chat instantly.

### list_folderless_lists
List Lists not contained in a Folder

### list_folders
Folders help organize multiple lists.

List all Folders in a Space

## Prompt Examples

**Prompt:** 
```
What are the tasks in the 'Design Sprint' list?
```

**Response:** 
```
Checking the 'Design Sprint' list for you...

Here are the current tasks:

| Task Name | Status | Priority |
| :--- | :--- | :--- |
| **Update Logo** | In Progress | High |
| **Finalize Colors** | To Do | Medium |
| **Font Selection** | Closed | Low |

Would you like me to get more details on any of these?
```

**Prompt:** 
```
Create a task for 'Fix CSS bug' in the 'Development' list.
```

**Response:** 
```
I have created the task **'Fix CSS bug'** in your **Development** list.

*   **Status:** To Do
*   **ID:** task_88291

Do you want me to add a description or a due date to this?
```

**Prompt:** 
```
Show me all the workspaces I have access to.
```

**Response:** 
```
You have access to the following workspaces:

*   **Product Team** (ID: 1234)
*   **Marketing Dept** (ID: 5678)
*   **Engineering Hub** (ID: 9012)

Which one would you like to explore further?
```

## Capabilities

### Create new tasks
Add new to-dos to specific lists using natural language.

### Pull task details
Get descriptions and due dates for any existing task.

### Browse project folders
See how your spaces and folders are organized.

### List all tasks
View every item in a specific list at once.

### View workspaces
See all the different teams and workspaces you belong to.

### Check user profiles
Retrieve your own profile and team member information.

## Use Cases

### Checking the Q3 Roadmap
A manager asks the agent to find the 'Q3 Roadmap' list. The agent uses list_space_lists to locate it and then lists all tasks.

### Logging a Bug
A developer tells the agent to log a new CSS bug in the 'Development' list. The agent uses create_new_task to add it instantly.

### Status Check
An ops lead asks for the status of the 'API Migration' project. The agent uses get_task_details to pull the latest status and date.

### Workspace Audit
A new hire asks what teams they have access to. The agent uses list_clickup_workspaces to show all available team environments.

## Benefits

- Stop switching tabs by using list_clickup_workspaces to see all your teams in one place.
- Get instant updates on project status with get_task_details to see due dates and descriptions.
- Build out your roadmap faster by using create_new_task to add items to specific lists on the fly.
- Navigate complex project structures easily using list_space_folders and list_space_lists.
- Keep your focus on the work by using list_list_tasks to see what is next without opening the app.
- Verify your own access and team status quickly with get_my_clickup_profile.

## How It Works

The bottom line is you get a hands-free way to manage your ClickUp projects from a chat window.

1. Subscribe to the ClickUp MCP on the Vinkius Marketplace.
2. Enter your ClickUp Personal API Token in your AI client settings.
3. Ask your agent to find tasks, create to-dos, or list your workspaces.

## Frequently Asked Questions

**Can the ClickUp MCP create new tasks for me?**
Yes, it can create new tasks in specific lists using natural language. You can tell your agent what needs to be done, and it will add it to the correct list automatically.

**How do I connect ClickUp to my AI agent?**
You just need your Personal API Token from your ClickUp settings. Once you paste that into your AI client, your agent can start interacting with your projects.

**Can it see my team's folders?**
Yes, it can list spaces, folders, and lists to help you navigate your hierarchy. This allows your agent to understand how your workspace is organized.

**Is this for project managers?**
It is perfect for project managers who need to audit progress and manage team capacity without clicking through complex dashboards.

**Can I see task due dates?**
Yes, it retrieves detailed metadata like descriptions and due dates for specific tasks, giving you a full picture of your project status in your chat.

**Does the ClickUp MCP work with Cursor or Claude?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**Can I see the subtasks for a specific task?**
Yes! Use the `get_task_details` tool with the task ID. The agent will fetch the full task record, which includes all subtasks nested within it.

**How do I find all the tasks in a specific list?**
Use the `list_list_tasks` tool. Provide the list ID, and your agent will return all tasks in that list, including their current statuses and priorities.

**Where do I find my ClickUp API Token?**
Log in to ClickUp, go to your **Personal Settings**, select **Apps**, and generate a **Personal API Token** under the API section.

**How do I find my ClickUp Personal API Token?**
Log in to ClickUp, navigate to **Settings** > **Apps**, and click **Generate** under the Personal API Token section.

**What is the difference between a Space and a List?**
A Space is a top-level grouping for high-level organization, while a List contains the actual individual tasks you want to track.

**Can I filter for archived tasks?**
The current toolset is optimized for active project management and typically retrieves non-archived tasks to maintain workflow focus.