# ClickUp MCP MCP

> ClickUp MCP lets you manage projects right from your chat interface. You can list all workspaces, monitor specific spaces and folders, and pull task details without opening the app. It tracks everything from project hierarchy to individual subtasks, keeping your team's workflow visible inside any AI client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-management, workflow-automation, workspace-management, subtasks, team-collaboration, productivity-tracking

## Description

Stop clicking through dashboards just to check a status update. This connector lets you talk to ClickUp about your projects instead. You can ask for an overview of every workspace you belong to and drill down into the exact task details, including descriptions or due dates. Need to start something new? You can create tasks and manage subtasks right in conversation. Because project data is so critical, we built this on Vinkius; that means your AI agent's actions are tracked by Vinkius AI Analytics. You always know exactly which spaces were checked, what data flowed through the request, and how much budget was used. It makes managing complex workflows straightforward, letting you focus on execution, not navigation.

## Tools

### create_new_task
Makes a fresh, editable task item within any specific list.

### get_my_clickup_profile
Retrieves key information about the user who is currently logged in.

### get_task_details
Gets a deep dive into one task, pulling everything from its description to its due date.

### list_clickup_workspaces
Lists all the major team areas (workspaces) that your account can see.

### list_list_tasks
Retrieves a list of every task contained within a single, designated list.

### list_space_folders
Shows all the folders that are structured inside a specific space.

### list_space_lists
Lists every smaller container (list) sitting within a given project space.

### list_workspace_spaces
Shows all the major functional areas (spaces) that belong to a specific workspace.

## Prompt Examples

**Prompt:** 
```
List all my ClickUp workspaces.
```

**Response:** 
```
Retrieving your ClickUp workspaces... I found 2: 'Product Team' (ID: 1234) and 'Marketing Dept' (ID: 5678). Which one would you like to see the spaces for?
```

**Prompt:** 
```
Show me the tasks in the 'Q2 Launch' list.
```

**Response:** 
```
Checking tasks in Q2 Launch... I found 5 items: 'Update Landing Page' (To Do), 'Finalize Copy' (In Progress), 'Security Audit' (Closed), and 2 others. Should I include subtasks?
```

**Prompt:** 
```
Create a new task called 'Prepare presentation' in list 'wf_123'.
```

**Response:** 
```
Creating task 'Prepare presentation'... The task has been successfully created in ClickUp. You can find it under the ID 'task_abc123'. Would you like to add a description or a due date?
```

## Capabilities

### View all teams
Lists every workspace (team) your account has access to.

### Map project structure
Walks through the hierarchy, showing which spaces contain which folders and lists.

### Check task status
Pulls granular information for any specific task, including its current status or due date.

### Build new tasks
Creates a fresh to-do item in a specified list.

### Check team details
Retrieves information about your own user profile or other team members.

## Use Cases

### The Project Manager needs an overview of capacity.
A PM asks their agent, 'Show me all the spaces I manage and list any tasks overdue in the Marketing Dept.' The agent uses `list_workspace_spaces` then filters for task details using `get_task_details`, giving the PM a single status report.

### The Developer needs to track a bug fix.
A developer asks, 'What's the latest on the login page bug?' The agent uses `list_space_lists` to find the correct list and then `get_task_details` to pull status updates and assigned owners.

### The Team Lead needs to audit structure.
A TL asks, 'Show me where all our documentation lives.' The agent uses `list_clickup_workspaces`, then calls `list_space_folders` sequentially until the entire project map is returned for review.

### The Ops Team needs to generate follow-ups.
After a meeting, an ops agent uses `create_new_task` to log the action item immediately into the 'Meeting Follow-up' list, ensuring nothing falls through the cracks.

## Benefits

- Stop opening the ClickUp app. You can use the connector to list all workspaces or get task details directly through your agent, saving you clicks.
- Map out complex project structures by using tools like `list_workspace_spaces` and `list_space_folders` to see the full hierarchy without clicking through tabs.
- Need a quick update on team capacity? Use the connector to check team member information via `get_my_clickup_profile`, instantly reporting out who's doing what.
- Don't forget follow-up work. You can use `create_new_task` when talking to your agent, ensuring that action items are logged immediately into the right list.
- Understand project scope quickly by using `list_space_lists` to see every container available within a primary space.

## How It Works

The bottom line is, once it’s connected, you treat ClickUp like any other data source through natural language prompts.

1. Subscribe to the MCP and enter your ClickUp Personal API Token.
2. Connect your preferred agent—like Claude, Cursor, or Windsurf—to Vinkius using that token.
3. Tell your AI client what you want done. For example, 'List all my workspaces' or 'Create a new task called X in Y list.'

## Frequently Asked Questions

**How does I use create_new_task with the ClickUp MCP?**
You tell your agent to make it for you. Just specify the list name and the task title, like 'Create a new task called Budget Review in the Finance List.' The agent handles the rest.

**Can I use get_task_details to see all information?**
Yes. `get_task_details` pulls every available piece of metadata for that task, including its description and due date, giving you a full picture in one go.

**Do I need list_clickup_workspaces to start?**
No, but it's helpful. Running `list_clickup_workspaces` first gives your agent the necessary context of all available teams before you start drilling down into specific spaces.

**Is list_space_folders better than list_space_lists?**
It depends on what you need. Use `list_space_folders` if you want to see the grouping structure, but use `list_space_lists` when you need to know which actual containers hold tasks.

**What is get_my_clickup_profile for?**
This tool retrieves information about your user account. You can ask it to confirm who you are or pull basic team member info when auditing project capacity.

**How do I use list_workspace_spaces to see all the different areas in my company?**
It retrieves a complete inventory of every space within your connected workspace. This is essential for seeing the top-level organizational breakdown before diving into specific folders or lists.

**What should I use list_space_lists for if I want to see all tasks?**
This tool shows every distinct list contained within a specified space. You must run this first to get the list ID, which you then feed into other tools like `list_list_tasks` to actually retrieve task data.

**If I need specific user info, is there any way to get it besides using get_my_clickup_profile?**
No, the system only provides access to your own profile details via `get_my_clickup_profile`. You cannot retrieve information for other team members unless they are explicitly part of a pre-defined user list.