# ClickUp MCP for AI Agents AI Agent Connect

> ClickUp MCP lets your AI agent manage your entire project management workspace. It handles task creation, status updates, and folder navigation so you don't have to switch tabs. Connect your ClickUp account to give your agent full visibility into your team's progress and hierarchy.

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

## Description

Managing a complex project usually means jumping between dozen of different lists and folders just to see what's actually getting done. This Connector changes that by letting your agent handle the heavy lifting of project navigation and task updates. Instead of manual data entry, you can tell your agent to create new tasks, update priorities, or pull detailed metadata for a specific project. It understands your ClickUp hierarchy, so it can find the right folder or list without you having to provide a long path every time. You'll find this Connector in the Vinkius catalog, where it connects your workspace to any compatible client. It turns your agent into a project coordinator that knows exactly where everything sits and who's responsible for what. You get to focus on the work while the agent handles the status updates and organizational overhead. No more hunting for list IDs or manually toggling between different project views. Your agent handles the administrative friction of project management so you can stay in your flow.

## Tools

### create_task
Create a new task in a specific list. You can set the name, description, and initial status.

### delete_task
Remove a specific task from your list. This helps keep your project workspace clean of obsolete items.

### get_task_details
Get all the info for a specific task. It pulls descriptions, assigned users, and custom fields.

### list_folderless_lists
See lists that aren't inside a folder. This is useful for finding top-level project items.

### list_folders
View all folders within a space. Use this to understand how your project hierarchy is organized.

### list_lists
See every list inside a specific folder. This helps you find the right place to add new tasks.

### list_spaces
View all spaces in your workspace. This is the best way to see your high-level project groupings.

### list_tasks
Get a list of tasks within a specific list. It supports pagination for handling large task volumes.

### list_workspaces
See every workspace you have access to. Use this to switch between different high-level project areas.

### update_task
Change the name, description, or status of an existing task. This keeps your project records accurate.

## Prompt Examples

**Prompt:** 
```
What's the status of the login bug?
```

**Response:** 
```
I've checked the **Login Bug** task in your **Web Development** list. 

*   **Status:** In Progress
*   **Priority:** High
*   **Assigned to:** Sarah Jenkins
*   **Last Update:** 2 hours ago

Would you like me to update the status or pull the full description?
```

**Prompt:** 
```
Create a task for the new logo design in the marketing list.
```

**Response:** 
```
Done! I've created the new task:

*   **Task Name:** New Logo Design
*   **List:** Marketing
*   **Status:** To Do

I've also added a placeholder description. Do you want me to add any specific details or assign it to someone?
```

**Prompt:** 
```
List all the tasks in the 'Website' folder.
```

**Response:** 
```
I've pulled the tasks from the **Website** folder. Here is the current summary:

| Task Name | Status | Assignee |
| :--- | :--- | :--- |
| Fix Header | Done | Mike |
| Update Footer | In Progress | Sarah |
| Mobile Optimization | To Do | Alex |

There are 3 more tasks in this folder. Would you like to see them?
```

## Capabilities

### Create new tasks
Tell your agent to add a new task to a specific list with a name, description, and status.

### Delete old tasks
Remove obsolete or completed tasks from your lists to keep your workspace clean.

### Pull task metadata
Get full details on any task including descriptions, assigned users, and custom fields.

### Navigate hierarchy
Let your agent move through workspaces, spaces, folders, and lists automatically.

### Update task statuses
Change task names, descriptions, or statuses in real-time using natural language.

### List project tasks
Retrieve lists of tasks from specific lists with support for large volumes via pagination.

## Use Cases

### Update statuses after a meeting
A project manager needs to update five tasks to In Progress. They ask the agent to do it, and it updates everything in ClickUp instantly.

### Pulling bug details into a dev environment
A developer wants to see the full description of a bug. The agent pulls the details from get_task_details so they don't have to open a browser.

### Auditing team workload
An ops lead needs to see all tasks in a specific folder. The agent uses list_folders and list_lists to gather the data and summarize the workload.

### Automating sprint creation
A team lead creates a new sprint. They tell the agent to create_task for every new item in the backlog, setting the priority and description automatically.

## Benefits

- Stop switching tabs by letting your agent update task statuses in ClickUp directly using update_task.
- Get full task metadata using get_task_details to see who is assigned and what is due without opening a browser.
- Organize your workspace faster by using list_folders to navigate your hierarchy and find the right lists.
- Keep your project records clean by using delete_task to remove finished or irrelevant items from your view.
- Manage large task volumes easily because list_tasks supports pagination for big projects with many items.
- See your entire team's scope across different projects with list_workspaces and list_spaces.

## How It Works

The bottom line is you get a project management assistant that lives inside your chat window.

1. Subscribe to the ClickUp MCP on the Vinkius Marketplace.
2. Copy your Personal API Token from your ClickUp dashboard under Settings and Apps.
3. Paste the token into your AI client to start managing your tasks.

## Frequently Asked Questions

**Can the ClickUp MCP create tasks for me?**
Yes, you can tell your agent to create new tasks with specific names, descriptions, and statuses directly in your ClickUp lists.

**Does the ClickUp MCP work with my existing folders?**
Yes, it can navigate your entire folder and list structure to find exactly where you need to manage your work.

**Can I use the ClickUp MCP to update project statuses?**
Yes, you can tell your agent to change statuses in real-time, which keeps your project board accurate without manual clicking.

**How do I connect my ClickUp account?**
You just need to grab your Personal API Token from your ClickUp dashboard settings and paste it into your AI client.

**Can it see my team's workload?**
Yes, the agent can list tasks across different spaces and folders to help you get a bird's-eye view of what everyone is working on.

**Will the ClickUp MCP help with my sprint planning?**
Yes, it can help you organize and create tasks for your next sprint, making it much faster to set up your team's upcoming work.

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