ClickUp MCP for AI Agents. Control your entire project hierarchy via conversation.
ClickUp MCP connects your AI agent directly into your full project workspace, letting you manage tasks, track goals, and reorganize complex projects using only natural conversation. Stop switching between different tools or digging through nested menus; just talk to your project structure. This single connection gives your agent the power to read every detail and write new tasks across all workspaces.
Claude 
ChatGPT 
Cursor 
Gemini 
Windsurf 
VS Code 
JetBrains 
Vercel Give Claude and any AI agent real-world access
You can list all workspaces, spaces, folders, and lists to map out your complete project hierarchy.
Retrieve comprehensive information on any specific task, including its description, assigned user, and custom fields.
Create, update the status of, or delete entire tasks using a simple command.
List all tasks within any specific list and filter them to understand current progress or individual workloads.
Ask an AI about this
Waiting for input…
What AI agents can do with ClickUp - 10 Tools for Project Management
These tools let your AI client read every piece of data—from listing all workspaces to updating a single task status—in the ClickUp platform.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using ClickUp MCPCreate Task
Creates a brand new task within a specified list, allowing you to set its initial status or description.
Delete Task
Permanently removes a specific task from your project structure.
Get Task Details
Retrieves all the metadata for one task, including its full description and custom...
List Folderless Lists
Shows a list of project lists that aren't contained inside any folder structure.
List Folders
Gives you an overview of all the folders available within a specific workspace space.
List Lists
Lists every single project list that resides inside a defined folder.
List Spaces
Provides an outline of all the major spaces grouped within your overall workspace.
List Tasks
Fetches and lists tasks from any given list, supporting pagination for huge datasets.
List Workspaces
Lists every single top-level workspace you have access to in ClickUp.
Update Task
Changes the name, description, or status of an existing task record.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The ClickUp integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with ClickUp, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ClickUp. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The Pain Point: Navigating Project Overload Solved with Vinkius AI Gateway
Today, managing projects means jumping through hoops. You open the dashboard, then you have to manually click into the right Space, find the correct Folder, and finally locate the List that holds the task. If a project has hundreds of items, it's an exhausting process of clicking through status columns and copy-pasting IDs just to figure out who owns what.
With this MCP, you treat your project structure like conversation. You simply ask your agent: 'What tasks are overdue in the marketing space?' It doesn't care about folders or spaces; it finds the data point instantly and gives you a clean answer.
Task & Folder Management
The biggest time sink today is administrative overhead. Changing statuses, updating descriptions, or even just seeing what lists are available requires jumping into the tool and running multiple manual commands.
Now, you delegate that entire process to your AI agent. You ask it to 'List all tasks in this folder and then update their status.' The complexity vanishes. You get actionable results without leaving the conversation window.
What your AI can actually do with this
Your AI client takes full control of your entire ClickUp environment, treating it less like a dashboard and more like an address book for action. You don't need to know which folder contains what; you just ask the agent to get it done. It can read through every workspace, space, and list to find exactly what you need.
For instance, if your team needs to update five tasks across three different projects, your agent handles the navigation and updates automatically, all from a single prompt.
This level of control lets you manage the full task lifecycle—from creating high-priority items to retrieving detailed metadata on who owns them and what their current status is. It's like having an administrative assistant who lives inside ClickUp. If your company uses other methods for automation, check out Vinkius; they host thousands of MCPs that let you connect all your services in one place so your AI agent doesn’t get lost.
No more manual toggling between project lists or digging through status folders just to figure out who's responsible for what. Your AI acts as a dedicated project coordinator, architecting and updating your entire pipeline based on simple conversation.
019dd0cf-8b50-72ac-8821-62562f38a64c 
Here's how it actually works
The bottom line is you get a single conversational interface that lets you read and write data across every part of your project setup without needing API calls or manual navigation.
Subscribe to the MCP on Vinkius, then grab your Personal API Token from the ClickUp dashboard settings.
Connect your preferred AI client (Claude, Cursor, etc.) using this token and authorize access to your accounts.
Use natural language commands in your agent to ask it to list workspaces, find task details, or create new items.
Who is this actually for?
This MCP is for anyone whose job involves coordinating multiple moving parts: Project Managers who hate jumping between dashboards, Operations Leads monitoring team capacity, and Software Teams running complex sprints. If your day involves status updates and cross-referencing project goals across different departments, you need this.
You use it to instantly retrieve task lists or update the statuses of dozens of tasks across multiple projects simply by telling your agent what needs changing.
You monitor team capacity and structure entire folder hierarchies, getting a clear view of who has bandwidth without manually checking every status column.
You manage complex sprints and automate task assignments by having your agent read existing tasks and then creating new ones for the next development cycle.
What Changes When You Connect
You stop manually toggling between tabs. Instead, you ask the agent to list all accessible workspaces and get an immediate map of everything your team uses.
Managing task status is instant. Use natural language commands to update tasks—like changing a 'To Do' item to 'In Progress'—without ever clicking into the task record itself.
It maintains high-fidelity records. When you need context, your agent retrieves complete task details, including custom fields and assigned users, keeping project history solid.
You can map out complex structures easily. You simply ask it to list all spaces or folders, getting a programmatic view of the entire project architecture.
Assigning work gets simpler. The MCP lets you create new tasks directly, assigning priority and defining scope using only spoken language prompts.
See it in action
The Quarterly Review
A Project Manager needs to see the status of 40 critical items spread across five different folders. Instead of spending an hour running reports, they ask their agent to list tasks from multiple lists and filter them by 'Due Date' or 'Status: Blocked'. The agent compiles a clean summary instantly.
Onboarding a New Team Member
An Operations Lead needs to show a new employee the project structure. They ask their agent to list all spaces and then list folders within the top-priority space. The agent walks them through the entire hierarchy, preventing confusion.
Emergency Bug Fix
A Software Team Lead learns a critical bug needs fixing. Instead of creating a task manually, they prompt their agent to create a high-priority task in the right list and assign it immediately. They then use get_task_details to confirm all metadata is correct.
Capacity Planning
An Ops Lead needs to know who has free bandwidth next month. They ask their agent to list tasks across several departmental lists and filter by 'Assignee' status, getting an immediate view of team workload capacity.
The honest tradeoffs
What to watch out for, and the recommended way to handle each one.
Over-relying on the UI
Spending 15 minutes clicking through Workspaces, then Spaces, then Folders, just to get a general overview of all active projects.
Ask your agent directly: 'List all accessible workspaces and spaces.' This gives you the entire map in seconds without navigating any dashboards.
Updating tasks piecemeal
Manually changing the status of a task, then remembering to go back and update the due date on another related task.
Tell your agent: 'Update all tasks in list XYZ by setting the status to Complete and adding the reviewer.' It handles multiple updates in one command.
Forgetting the exact ID
Trying to update a task but only remembering the name, leading to an error because you need the specific List or Folder ID.
First use list_lists to get the list IDs. Then tell your agent: 'Update the task in list ID 789'—it knows exactly where to look.
When It Fits, When It Doesn't
Use this MCP if your primary need is conversational control over a complex, deep project structure and task lifecycle. You want an AI agent that acts like a super-powered administrative assistant for ClickUp, allowing you to map the hierarchy, update statuses, or create items without touching the UI.
Don't use this if you only need simple data export; then a dedicated API wrapper might be cleaner. Don't use it if your work involves connecting ClickUp data into an entirely different system (like accounting); for that, you need a middleware integration tool. This MCP is strictly about interacting with the internal structure of ClickUp itself.
Questions you might have
Can I use ClickUp MCP to see every project workspace? +
Yes, you can list all accessible workspaces using list_workspaces. This function gives you a top-level overview of every major area in your company's structure.
How do I create a task with specific metadata using ClickUp MCP? +
You use the create_task tool. You can provide not only the task name but also optional status and detailed descriptions when creating it.
Is there a way to find all my project folders? (ClickUp MCP) +
Yes, you can use list_folders. This tool helps you see all the organized containers within a specific space, giving you an architectural view of your projects.
Does ClickUp MCP support updating tasks across different lists? +
Yes. You first identify the necessary lists using list_lists, and then use the update_task tool to make changes, like changing status or description, in each one.
What if I want to see tasks that aren't organized in a folder? (ClickUp MCP) +
For those floating items, use list_folderless_lists. This tool specifically finds and reports on lists that exist outside of the main folder structure.