# ClickUp MCP > ClickUp MCP connects your project management data to any AI agent. It lets you manage tasks, track goals, and map complex hierarchies across work, spaces, folders, and lists—all through natural language conversation. You stop toggling between dashboards and start directing your projects using only talk. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-tracking, workflow-automation, hierarchy-management, team-collaboration, goal-setting, time-tracking ## Description Stop bouncing between task boards, document libraries, and status reports just to get a project overview. This MCP connects your entire ClickUp workspace to your AI client, giving it full visibility into every detail of your project structure. You treat the whole system like one giant database that you can query with plain English. Need to know what tasks are pending in the 'Marketing' folder but belong to a 'Q3 Goal'? Your agent handles that complex navigation for you, pulling together statuses and metadata it wouldn't normally see. When your AI client talks to this MCP, it doesn't just create records; it understands relationships—it knows that a specific task lives inside a list, which belongs in a folder, all within a space. This makes your agent function less like a simple data entry tool and more like an actual project coordinator. Accessing this power through Vinkius means you don't have to worry about connecting multiple systems; just connect once from any MCP-compatible client, and you get total control of the entire ClickUp ecosystem. ## Tools ### create_task Makes a new task appear in any specified list, letting you set the name and initial description. ### delete_task Permanently removes a specific task from your ClickUp workspace. ### get_task_details Pulls all the deep metadata for one task, including who owns it and what custom fields are filled out. ### list_folderless_lists Retrieves a list of all lists that aren't contained inside any folder structure. ### list_folders Shows you every folder available within a specific space, helping map the hierarchy. ### list_lists Displays all individual lists that sit inside one parent folder. ### list_spaces Provides a view of the top-level groupings, showing which spaces exist in your workspace. ### list_tasks Retrieves all tasks contained within a single list, supporting pagination for huge task counts. ### list_workspaces Lists every major workspace you have access to in your organization's account. ### update_task Changes an existing task's name, status, or description without needing a manual edit session. ## Prompt Examples **Prompt:** ``` List all ClickUp Workspaces I have access to. ``` **Response:** ``` I've retrieved your accessible workspaces. You currently belong to: 'Vinkius Global' (ID: 123) and 'Personal Tasks' (ID: 456). Which one should we explore for project spaces? ``` **Prompt:** ``` Show the tasks in list ID '789' and their current statuses. ``` **Response:** ``` Scanning list 789... I found 5 active tasks, including 'Redesign UI' (In Progress) and 'API Documentation' (To Do). Would you like the detailed metadata for the 'In Progress' task? ``` **Prompt:** ``` Create a high-priority task 'Fix Login Bug' in list '789'. ``` **Response:** ``` Action complete! I've created the high-priority task 'Fix Login Bug' in specified list (ID: 789). It's now visible on your dashboard for your team to address. Need help assigning a crew member? ``` ## Capabilities ### Map Project Structure List all available workspaces, spaces, folders, and lists to understand your project's full organizational depth. ### Manage Task Lifecycles Create new tasks or update existing ones—changing status, priority, or description—without logging into the native app. ### Retrieve Project Details Pull complete records for any task, including custom fields and assigned users, to build accurate reports. ### Audit Team Capacity Programmatically list tasks across entire lists or filter whole folders to gauge team workloads and bottlenecks. ## Use Cases ### Auditing Project Scope The Ops Director needs to know if the new 'Compliance' space was built correctly. They ask their agent to first run `list_workspaces`, then select 'Compliance', and finally execute `list_folders` to confirm every required section is present. ### Mid-Sprint Status Check A Project Manager asks, 'Which tasks in the main sprint folder are currently stalled?' The agent runs `list_tasks` and filters for items that haven't been touched or updated recently, giving an instant bottleneck report. ### Onboarding a New Team Member A manager needs to show a new hire where everything lives. The agent runs `list_spaces` and presents the full organizational chart, allowing the manager to guide them to the right project structure immediately. ### Batch Updating Deliverables The team just finished a major phase. A Software Lead asks the agent to update all related tasks by running `update_task` across multiple lists, setting their status to 'Ready for QA' in one go. ## Benefits - Stop manually navigating deep structures. You can use `list_workspaces` to see all available areas at once, immediately giving you context for where a missing task might be. - Manage tasks with surgical precision. Use `update_task` when the status changes, or `create_task` when something new needs logging. It's instant, direct control. - Get deep data without clicking anything. The `get_task_details` tool pulls all metadata—descriptions and custom fields—in one query, saving you ten minutes of scrolling. - Understand your whole scope at a glance. By running through `list_spaces`, then `list_folders`, and finally `list_lists`, your agent builds the entire organizational map for you. - Automate reporting on team progress. Instead of manually counting items, use `list_tasks` across specific lists to get a real-time count of completed or overdue work. ## How It Works The bottom line is: your AI client becomes a dedicated project manager that talks directly to ClickUp, letting you bypass the GUI entirely. 1. First, you subscribe to this MCP on the Vinkius Marketplace. 2. Next, you grab your Personal API Token from the ClickUp dashboard settings and connect it to your AI client. 3. Finally, you prompt your agent—'List all tasks in Q4 planning folders with status 'Needs Review'. '—and get an immediate, actionable list. ## Frequently Asked Questions **How do I see everything in my workspace?** Use the `list_workspaces` tool. This function shows you all major workspaces you have access to, giving you the highest-level view of your organization's scope. **What is the difference between list_folders and list_lists?** The `list_folders` tool shows groups that hold related lists. The `list_lists` tool, conversely, shows all the individual containers of tasks that sit inside a specific folder. **Can I update task statuses with the update_task tool?** Yes, you can use `update_task`. You just need to tell your agent which task needs changing and what its new status should be. It handles the rest of the data structure. **How do I check for tasks outside of any organized folder?** Run `list_folderless_lists`. This specifically retrieves all lists that aren't nested in a parent folder, making sure you don't miss critical work items. **What credentials do I need to run the `list_workspaces` tool?** You must provide a Personal API Token from your ClickUp dashboard. This token authorizes all actions, giving your agent permission to read and write data across your entire project hierarchy. **What specific metadata does the `get_task_details` tool return?** It provides a complete record for a single task. You get details like custom fields, assigned users, descriptions, and status—giving your agent high-fidelity data necessary for accurate reporting. **Besides changing the status, what can I modify with `update_task`?** You can update more than just the status. The tool lets you change a task's name and its description. This means your agent can refine project items or add necessary context programmatically. **Does using `list_tasks` handle very large amounts of data?** Yes, the tool supports pagination. This mechanism allows your agent to retrieve huge numbers of tasks by making sequential calls, ensuring you capture all data even in massive lists. **How do I find my ClickUp Personal API Token?** Log in to ClickUp, navigate to **Settings** > **Apps**, and click **Generate** under the Personal API Token section. **What is the difference between a Space and a List?** A Space is a top-level grouping for high-level organization, while a List contains the actual individual tasks you want to track. **Can I filter for archived tasks?** The current toolset is optimized for active project management and typically retrieves non-archived tasks to maintain workflow focus.