ClickUp MCP. Manage projects and tasks from your chat window.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
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.
Lists every workspace (team) your account has access to.
Walks through the hierarchy, showing which spaces contain which folders and lists.
Pulls granular information for any specific task, including its current status or due date.
Creates a fresh to-do item in a specified list.
Retrieves information about your own user profile or other team members.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
ClickUp Task & Workspace Management (8 Tools)
Use these tools to perform specific actions like creating tasks, listing spaces, or retrieving detailed information about projects directly through your AI agent.
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 on Vinkius019d7572create new task
Makes a fresh, editable task item within any specific list.
019d7572get my clickup profile
Retrieves key information about the user who is currently logged in.
019d7572get task details
Gets a deep dive into one task, pulling everything from its description to its due date.
019d7572list clickup workspaces
Lists all the major team areas (workspaces) that your account can see.
019d7572list list tasks
Retrieves a list of every task contained within a single, designated list.
019d7572list space folders
Shows all the folders that are structured inside a specific space.
019d7572list space lists
Lists every smaller container (list) sitting within a given project space.
019d7572list workspace spaces
Shows all the major functional areas (spaces) that belong to a specific workspace.
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 every 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 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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 every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Navigating project boards is a huge time sink.
Today, managing projects means jumping between tabs: checking the main workspace overview, clicking into a space just to see the folder structure, and then opening another tab to find the list you need. You spend most of your time navigating the clicks instead of doing the work.
With this MCP, you talk to your agent directly. Instead of manual navigation, you simply ask for an overview using `list_workspace_spaces` or check a specific item's status with `get_task_details`. You get the answer immediately without opening a single dashboard tab.
Get project structure clarity with list_space_lists.
Manually figuring out if an item belongs to 'Design' or 'Copywriting' means clicking through the space, folder, and then listing every single container until you find the right spot. It’s tedious work that slows down project kickoff.
Using `list_space_lists` lets your agent instantly return a list of all available containers in a given space. You know exactly where to look, cutting out hours of structural investigation.
What you can do with this MCP connector
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.
019d7572-b62a-70ce-8ed4-37ccaa2dcde1 
How ClickUp MCP Works
- 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.'
The bottom line is, once it’s connected, you treat ClickUp like any other data source through natural language prompts.
Who Is ClickUp MCP For?
Project Managers and Team Leads who spend too much time navigating confusing dashboards. This MCP lets you get project oversight instantly without opening the app.
Monitors task progress across multiple team members by asking for details or listing tasks in a specific list.
Audits the full project structure, using tools to list all workspaces and map out spaces/folders before reporting status meetings.
Quickly looks up task details or creates new to-do items directly in their chat window while writing code.
What Changes When You Connect
- 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_spacesandlist_space_foldersto 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_taskwhen talking to your agent, ensuring that action items are logged immediately into the right list. - Understand project scope quickly by using
list_space_liststo see every container available within a primary space.
Real-World 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.
The Tradeoffs
Treating it like simple data lookups.
Asking the agent for a task ID and then just using it. This ignores the full context needed to manage the item's lifecycle.
→
Always combine actions. First, use list_space_lists to confirm the target list. Then, use get_task_details or create_new_task with that confirmed context.
Trying to manage cross-app data.
Assuming the agent can pull customer records from a separate CRM and then update them in ClickUp. The MCP only handles ClickUp structure.
→
Focus on pure ClickUp logic. Use get_my_clickup_profile for team data, or use multiple MCPs chained together if you need to connect two different platforms.
Missing the initial scope check.
Asking 'What tasks are due?' without telling the agent which space or list to look in. The system fails because context is missing.
→
Always start by listing the containers: use list_clickup_workspaces first, then narrow it down with list_space_lists before checking task status.
When It Fits, When It Doesn't
Use this MCP if your core pain is visualizing and managing complex project hierarchies within ClickUp. You need to check statuses, map out spaces (using list_workspace_spaces, list_space_folders, etc.), or create follow-up tasks on the fly. Don't use it if you primarily manage client communications—for that, you need a dedicated messaging MCP. Similarly, don't expect complex data transformations; this tool provides structured reads and writes based on existing ClickUp fields (like description or due date). If your workflow requires chaining task updates across multiple platforms, build an automation using Vinkius to combine this connector with another system.
Common Questions About ClickUp MCP
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.
Multi-server workflows that include ClickUp MCP
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
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.