ClickUp MCP. Manage projects and track tasks using natural language.
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. Manage your entire project lifecycle directly from your AI agent. Use this server to list workspaces, check task statuses, create to-dos, and map out complex project hierarchies without opening the ClickUp dashboard.
It gives your agent full visibility into your team's structure, from top-level workspaces down to individual subtasks.
What your AI agents can do
Create new task
Creates a new task in a specific ClickUp list.
Get my clickup profile
Retrieves details about the user currently logged into ClickUp.
Get task details
Fetches detailed information for one specific task ID.
List all workspaces, spaces, folders, and lists to understand the entire project hierarchy.
Retrieve detailed information about any specific task, including its due date, description, and current status.
Generate new tasks or add subtasks to existing lists, maintaining workflow continuity.
Retrieve details about your user profile or any specified team member.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
ClickUp MCP Server: 8 Tools for Project Management
Use these tools to list workspaces, map nested folders, retrieve task details, and create new items, all controlled by your AI agent.
019d7572create new task
Creates a new task in a specific ClickUp list.
019d7572get my clickup profile
Retrieves details about the user currently logged into ClickUp.
019d7572get task details
Fetches detailed information for one specific task ID.
019d7572list clickup workspaces
Lists all workspaces (teams) that the user is a member of.
019d7572list list tasks
Lists all tasks contained within a specified list.
019d7572list space folders
Lists all folders that exist inside a specific Space.
019d7572list space lists
Lists all lists that exist inside a specific Space.
019d7572list workspace spaces
Lists all spaces contained within a given 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,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
You've got a whole project spread out in ClickUp, and you don't wanna open the damn dashboard just to check something. This server lets your AI agent handle your whole project lifecycle—listing workspaces, checking task statuses, creating to-dos, and mapping out complex project hierarchies—all without you touching the ClickUp site.
It gives your agent full visibility into your team's structure, from the top-level workspaces right down to individual subtasks. You'll use this server to run tools like list_clickup_workspaces to see every workspace (or team) you're part of. You can then drill down into the structure using list_workspace_spaces to get a rundown of all the spaces inside a workspace.
Next, you can scope out the containers with list_space_folders to list all folders inside a specific space, and then narrow it down again with list_space_lists to see every list inside a folder. Finally, you can pinpoint specific tasks by running list_list_tasks to get a rundown of all tasks in a given list.
When you need the nitty-gritty on a single task, get_task_details fetches all the info—the due date, the description, the current status—for that specific task ID. Need to update something? You can use create_new_task to generate a new task right in a specific list. You can also check who's on the payroll by running get_my_clickup_profile to grab details about the user logged into ClickUp.
If you need info on another team member, the agent can handle that too. This whole setup lets your agent keep track of your team and your projects, so you don't gotta jump between apps.
How ClickUp MCP Works
- 1 Subscribe to the ClickUp MCP Server and provide your Personal API Token (from Settings > Apps).
- 2 Ask your AI agent a question, like 'List all my workspaces,' or 'What's the status of the Q2 launch task?'
- 3 The agent calls the specific tool (e.g.,
list_clickup_workspaces) and returns the structured data directly to you.
The bottom line is, you tell your agent what you need, and it pulls the specific data from ClickUp without you having to navigate the dashboard.
Who Is ClickUp MCP For?
Project Managers, Team Leads, Developers, and Ops Engineers. If you spend time clicking through dashboards just to find out 'who is doing what,' this is for you. It lets you manage complex projects and audit team capacity using natural language, cutting out the clicks.
Monitor task progress across multiple teams and check team capacity by asking the agent, 'Which workspaces are lagging?'
Audit project hierarchies and task statuses by having the agent map out the full structure of a Space or Folder.
Look up specific task details or create new to-dos straight from the chat interface without opening the application.
Verify complex workspace configurations and monitor organizational productivity by querying user and space metadata.
What Changes When You Connect
- See task status and details instantly. Use
get_task_detailsto pull up any task's full history, due date, and priority without navigating the dashboard. - Map your entire project structure.
list_clickup_workspacesandlist_workspace_spaceslet your agent map out every space and team you belong to, helping you see the big picture. - Build out workflows from chat. Use
create_new_taskto generate a task and add subtasks in a list, keeping your team organized without leaving your chat. - Audit team roles and capacity.
get_my_clickup_profileand other user tools let you quickly verify who is on the team and what their roles are. - Understand the hierarchy. The sequence of tools (
list_workspace_spaces->list_space_lists) allows your agent to map the full path from workspace down to the list level. - Save time on reporting. Instead of building custom reports in ClickUp, ask your agent to gather the necessary task metadata directly.
Real-World Use Cases
Checking the status of a major project
A PM needs to know the status of the 'Q2 Launch' tasks. They ask their agent to check the list. The agent uses list_list_tasks and get_task_details, summarizing that 'Update Landing Page' is 'To Do' and 'Finalize Copy' is 'In Progress.' The PM gets a bulleted summary instantly.
Mapping a new team's structure
An Ops Engineer joins and needs to know the full scope of the department. They ask the agent to map the structure. The agent runs list_clickup_workspaces, then list_workspace_spaces, and finally list_space_folders, giving a complete, nested map of the project environment.
Creating a task on the fly
A Developer is in a meeting and needs to record an action item. They prompt the agent: 'Create a task called X in list Y.' The agent uses create_new_task and confirms the ID, logging the action immediately.
Verifying task ownership
A Team Lead needs to see who owns a specific task. They ask the agent for details on the task ID. The agent uses get_task_details and reports the assignee, allowing the lead to follow up without opening the task.
The Tradeoffs
Trying to list everything at once
A user might assume they can ask, 'Give me all tasks.' This is too vague and requires the agent to guess the scope, potentially failing or retrieving too much data.
→
Start by defining the scope. First, use list_clickup_workspaces to narrow down the team. Then, use list_workspace_spaces to select the project area, and finally, list_space_lists to pinpoint the exact list.
Manually checking task status
A user logs into ClickUp, clicks through the main dashboard, finds the task, and manually checks the status dropdown. This takes several clicks and requires context switching.
→
Just ask the agent. Prompt the agent to 'Get task details for [ID]'. It uses get_task_details and gives you the status, due date, and owner immediately.
Assuming one tool covers everything
A user tries to create a task, but forgets to specify the target list. The create_new_task tool will fail because it needs the target context.
→
Always provide the full context. If you need to create a task, first use list_space_lists to confirm the target list name, and then run create_new_task with the correct parameters.
When It Fits, When It Doesn't
Use this if you need to manage or view structured data within a complex, multi-level project environment (Workspaces > Spaces > Folders > Lists > Tasks). It is perfect for auditing, reporting, and automation where the data structure is rigid. Don't use this if your goal is simple, unstructured communication (e.g., 'send a quick reminder'). For that, use a general messaging or notification tool instead. If you just need to look up a single piece of information without needing the full context, a simple database lookup tool might suffice, but ClickUp is best for structured workflow management.
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.
Available Capabilities
Project status shouldn't require jumping between 5 tabs.
Today, checking a project's status means logging into ClickUp, finding the correct workspace, drilling down into the right Space, locating the List, and then finding the specific task. You're clicking through 5 levels of navigation just to see if a task is done.
With the ClickUp MCP Server, you tell your agent what you need. You ask, 'What's the status of the Q2 launch tasks?' and it runs the necessary tools (`list_list_tasks`, `get_task_details`) to return a clean, actionable summary.
ClickUp MCP Server: Control the entire task lifecycle.
The manual process of creating tasks involves opening the app, navigating to the list, clicking 'New Task,' filling in the title, description, and subtasks one by one. It's tedious and you'll lose your place.
Now, you simply ask your agent to 'Create a new task called X in list Y.' The agent runs `create_new_task` and handles the entire creation process—title, list assignment, and subtasks—in a single, conversational step.
Common Questions About ClickUp MCP
How do I list all my workspaces using the ClickUp MCP Server? +
Use the list_clickup_workspaces tool. This will pull a list of all teams you belong to, giving you the high-level overview you need to start your project audit.
Can I find out the status of a task using the ClickUp MCP Server? +
Yes, use get_task_details. You just need the task ID. This tool returns the current status, due date, and all metadata associated with that single task.
How do I map the folder structure in ClickUp using the ClickUp MCP Server? +
You need a chain of calls. First, run list_workspace_spaces to get the top level. Then, use list_space_folders on the resulting Space ID to map the folder structure.
What is the best way to create a new task with the ClickUp MCP Server? +
Use create_new_task. You must specify the target list ID and the task title. This tool handles the creation, making it a single, reliable command.
Does the ClickUp MCP Server track team members? +
Yes. You can use get_my_clickup_profile to get information about your own user, and other tools allow you to retrieve team member details.
How do I get detailed information for a specific task using the ClickUp MCP Server? +
You use the get_task_details tool. This tool pulls specific metadata—like descriptions, assigned users, and due dates—for any task ID you provide. It's great for auditing tasks without navigating the ClickUp UI.
What can I do with `list_workspace_spaces` in the ClickUp MCP Server? +
The list_workspace_spaces tool shows all the major organizational containers (spaces) within a workspace. This lets your agent understand the overall structure before you dive into folders or lists.
How does the ClickUp MCP Server manage user data, like team member profiles? +
You use the get_my_clickup_profile tool to retrieve authenticated user information. It also lets your agent access general team member data, helping you verify who's assigned to what.
Can I see the subtasks for a specific task? +
Yes! Use the get_task_details tool with the task ID. The agent will fetch the full task record, which includes all subtasks nested within it.
How do I find all the tasks in a specific list? +
Use the list_list_tasks tool. Provide the list ID, and your agent will return all tasks in that list, including their current statuses and priorities.
Where do I find my ClickUp API Token? +
Log in to ClickUp, go to your Personal Settings, select Apps, and generate a Personal API Token under the API section.
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.
More in this category
Ninehire
Hire smarter with a recruitment platform that posts jobs, screens applicants, and moves the best candidates through your pipeline.
Clinical Medication Schedule Generator
Empower your AI Agent with deterministic medication scheduling. Effortlessly orchestrate strict multi-day dosage timelines offline, guaranteeing absolute privacy and temporal precision.
OPML Podcast & RSS Parser
Turn standard OPML export files from your podcast app or RSS reader into clean JSON data. Let your AI analyze your subscriptions and become your personal content curator.
You might also like
BLS Wages — OEWS Occupational Employment
The holy grail of HR data. Use Occupational Employment and Wage Statistics (OEWS) to extract exact median earnings broken down by detailed professions and states.
Heybox
Access Heybox (小黑盒) gamer database — track Steam/PUBG/CS2 statistics and monitor community trends directly from any AI agent.
SeaTable
Build collaborative databases with spreadsheet simplicity and relational power for project management, CRM, and asset tracking.