# ClickUp MCP > 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. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-management, workflow-automation, workspace-management, subtasks, team-collaboration, productivity-tracking ## Description 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. ## Tools ### create_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 ClickUp. ### get_task_details You can get a deep dive into a single task, including its full description and due date. ### 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 space. ### 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. ## 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 ### List all workspaces Your agent retrieves a list of every team workspace you belong to. ### Understand project structure You get a full map of spaces, folders, and lists within any given workspace or space. ### Retrieve task status The MCP pulls detailed information on specific tasks, including their current status and priority. ### Manage project to-dos You can create new tasks or manage subtasks right from your chat interface. ### Check user profiles The agent provides information about you and other team members within the workspace. ## Use Cases ### 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. ## Benefits - 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. ## How It 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. 1. Subscribe to this MCP using your ClickUp Personal API Token, which you get from your account settings. 2. Connect your preferred AI client (like Claude or Cursor) through Vinkius and authenticate the token. 3. 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. ## Frequently Asked Questions **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.