ClickUp MCP for AI Agents. Ask questions, manage projects.
ClickUp MCP connects your AI client directly to your entire ClickUp workspace. You manage complex projects by asking natural language questions instead of navigating endless dashboards. Use it to track task statuses across multiple spaces, audit project structures, and create new to-dos without ever leaving your chat window.
Give Claude and any AI agent real-world access
Your agent retrieves a list of every team workspace you belong to.
You get a full map of spaces, folders, and lists within any given workspace or space.
The MCP pulls detailed information on specific tasks, including their current status and priority.
You can create new tasks or manage subtasks right from your chat interface.
The agent provides information about you and other team members within the workspace.
Ask an AI about this
Waiting for input…
What AI agents can do with ClickUp: 8 Tools for Project Management
These tools let you interact with every core feature of ClickUp—from listing your entire workspace structure to creating brand new tasks in minutes.
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 New Task
This tool adds a brand new task into any specified list within ClickUp.
Get My Clickup Profile
It retrieves basic profile information for the user who is currently logged in to...
Get Task Details
You can get a deep dive into a single task, including its full description and due...
List Space Folders
This function lists every folder that exists inside a particular space.
List Space Lists
It provides a list of all the individual working lists contained within a specific...
List Workspace Spaces
This tool shows every major 'area' or space that is part of your main team workspace.
List List Tasks
You can ask it to pull a list of all the tasks currently sitting in a specific working list.
List Clickup Workspaces
It lists every workspace (or team) that you have been added to within your account.
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.
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 status update nightmare Solved with Vinkius AI Gateway
Every week, the same thing happens. You open ClickUp and face a massive dashboard filled with nested spaces, folders, and lists. To figure out if Project Alpha is on track, you have to click into the 'Marketing' space, then find the 'Q2 Launch' folder, drill down to the list, and finally scroll through dozens of tasks just to see who owns what.
With this MCP, that process disappears. You simply ask your agent, 'What's the status of Project Alpha?' The system aggregates all necessary data—the spaces, lists, and task statuses—and hands you a clean summary in seconds. It turns hours of dashboard clicking into one conversation.
Task & Space Management with ClickUp
You no longer have to manually map out project dependencies or verify the full scope of a team's work. You can use `list_space_lists` and `list_space_folders` together, letting your agent provide an immediate visual inventory of every single component in a space.
The MCP treats ClickUp as an API endpoint that talks back to you. It means complex organizational data—from listing workspaces to creating new tasks—is accessible instantly through natural conversation.
What your AI can actually do with this
Connecting this MCP turns your project management system into a conversation. You tell your AI agent what you need—like checking if the marketing team's launch tasks are blocked or listing every space under the 'Product' umbrella—and it handles the data retrieval. Instead of clicking through multiple tabs to build a status report, your agent does the heavy lifting instantly.
It lets you drill down from an entire workspace down to individual subtasks and their due dates using simple conversation. You can monitor team capacity or audit project hierarchies just by asking. When you subscribe to this MCP via Vinkius, you get immediate access to these deep capabilities within any MCP-compatible client, making your existing workflow dramatically simpler.
019d7572-b62a-70ce-8ed4-37ccaa2dcde1 Here's how it actually works
The bottom line is, you talk to your AI client like talking to a colleague who already has access to every piece of project data.
Subscribe to this MCP using your ClickUp Personal API Token, which you get from your account settings.
Connect your preferred AI client (like Claude or Cursor) through Vinkius and authenticate the token.
Ask your agent a question. For example: 'List all tasks in the Q2 launch list.' The MCP executes the query and sends back structured project data.
Who is this actually for?
This MCP is built for people whose jobs involve coordinating efforts across dozens of moving parts. It’s for the Ops Engineer tired of clicking through complex dashboards at 2 a.m. to verify if a project has hit a roadblock, or the Project Manager who needs an instant status report without opening multiple browser tabs.
Checks team capacity and monitors task progress across multiple lists just by asking their agent for a summary.
Audits project hierarchies—checking which spaces contain what folders, and if the overall structure makes sense—without having to click through the main dashboard.
Quickly looks up detailed task specifications or creates new follow-up to-dos directly in their chat environment while coding.
What Changes When You Connect
Stop opening dashboards just to check status. You can ask your agent for a list of all tasks in the 'Q2 Launch' list using list_list_tasks, getting immediate data without navigation.
Audit your project structure instantly. Use list_workspace_spaces and then list_space_folders to map out exactly how every team area is organized, saving hours of clicking through nested menus.
Need a quick follow-up? If you know the details but need a reminder, use create_new_task to instantly generate a new action item in the correct list.
Getting comprehensive task data used to require multiple steps. Now, with get_task_details, your agent pulls all metadata, including descriptions and due dates, into one clean response.
Never lose context on who's doing what. Use list_clickup_workspaces first to narrow down the team area, then check user profiles using get_my_clickup_profile to verify ownership.
See it in action
The Weekly Status Check
A Project Manager needs to know which teams are ready for the next phase. They simply ask their agent, 'List all my ClickUp workspaces.' The MCP responds with a list of available team areas, allowing them to check progress in one conversation thread.
Onboarding New Team Members
A Team Lead needs to understand the project's full scope. They ask their agent to 'List all spaces within this workspace.' The MCP immediately provides a complete organizational map, preventing them from getting lost in confusing folders and lists.
Following Up on Blockers
A Developer is stuck waiting for sign-off. Instead of emailing three people, they ask their agent to 'Get task details' for the specific item ID. The MCP retrieves all necessary metadata in one shot so they know who needs to act next.
Quick To-Do Generation
A meeting wraps up and action items are generated. Instead of manually creating tasks, a user tells their agent: 'Create a new task called X in the Y list.' The MCP handles the creation instantly.
The honest tradeoffs
What to watch out for, and the recommended way to handle each one.
Treating it like a simple search bar
Asking your agent, 'What's going on with the launch?' and expecting it to magically pull everything. It needs structure.
Be specific about what you need. Ask: 'List all tasks in the Q2 Launch list.' This uses list_list_tasks and gives a precise data set.
Overloading one prompt
Trying to ask for workspaces, spaces, folders, and task details all at once. The agent might get confused.
Break it into steps. First, use list_workspace_spaces to scope the area, then follow up with list_space_folders for structure.
Ignoring permissions
Assuming the agent can see every piece of data in ClickUp even if you don't have access. It will fail silently or give wrong info.
The MCP respects your API token and workspace permissions. If a task is private, it won't show up. Always check get_my_clickup_profile first to ensure context.
When It Fits, When It Doesn't
Use this MCP if the core of your job involves auditing complex organizational data structures or running regular status reports across many interconnected projects in ClickUp. If you constantly need to know 'Where is X?' or 'Who owns Y?', this tool solves that by treating your entire workspace as a searchable database.
Don't use it if your only goal is simple note-taking or drafting documents. For pure content generation, stick with an LLM alone. You should use this MCP when the data itself—the lists, tasks, and hierarchy—is the bottleneck, not the writing. If you just need to see what teams you belong to before proceeding, start with list_clickup_workspaces. If you're only worried about one specific task, get_task_details is your best bet.
Questions you might have
How do I list all my ClickUp workspaces using the ClickUp MCP? +
You use the list_clickup_workspaces tool. It provides a comprehensive list of every workspace (or team) you are currently associated with in your account.
Can I create tasks without knowing the space ID first? (ClickUp MCP) +
No, to use create_new_task, you must specify which list the task should go into. You can first use list_workspace_spaces and then follow up with a listing tool to get the correct list ID.
What data does the ClickUp MCP give me about individual tasks? +
The MCP retrieves detailed information via get_task_details. This includes statuses, priorities, descriptions, and due dates for a specific item.
Does the ClickUp MCP help me understand team structure? +
Yes. You can map out your entire project hierarchy by first calling list_space_folders inside a space to see all its sub-sections, and then checking which lists are within those folders.
Is the ClickUp MCP safe to use for sensitive client data? +
The connection uses your personal API token and only accesses data visible through your ClickUp account permissions. The MCP adheres to standard secure practices when retrieving task metadata.
Powerful workflows you can unlock today
Generate Agency Reports Automatically Using MCP
Your project manager spends every Friday afternoon building 12 client reports from scratch , copying task statuses from ClickUp and time entries from Harvest into spreadsheets instead of billing those 6 hours
MCP Servers for Multi-Client Sprint Management
Your dev team tracks their work in Linear but the PM reports to clients in ClickUp , which means every sprint update is manually transcribed between two tools, and by the time the client sees it in ClickUp the data is already outdated
MCP Servers for Small Business Operations
Tasks organized, design templates found, team updates posted , run your small business from one conversation
MCP Workflow for Figma to Dev Handoffs
The designer finished the mockup two weeks ago and the developer just discovered it has 47 components but zero specs , now the sprint is blocked by a 'quick question' Slack thread with 130 messages