ClickUp MCP for AI. Control every task, folder, and space in your project hierarchy.

Q: How do I see everything in my workspace?

Use the listworkspaces tool. This function shows you all major workspaces you have access to, giving you the highest-level view of your organization's scope.

Q: What is the difference between listfolders and listlists?

The listfolders tool shows groups that hold related lists. The listlists tool, conversely, shows all the individual containers of tasks that sit inside a specific folder.

Q: Can I update task statuses with the updatetask tool?

Yes, you can use updatetask. 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.

Q: How do I check for tasks outside of any organized folder?

Run listfolderlesslists. This specifically retrieves all lists that aren't nested in a parent folder, making sure you don't miss critical work items.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

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.

What your AI can do

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.

+ 7 more capabilities included

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.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

ClickUp: 10 Tools for Complete Project Control

These ten tools give your AI client granular control over every part of your ClickUp instance, from viewing top-level spaces to updating individual task statuses.

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 Vinkius

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...

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...

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...

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.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The ClickUp integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "clickup-alternative": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the ClickUp tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"clickup-alternative": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

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

Start building

Make Your AI Do More

Start with ClickUp, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,100+ 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

Your data is protected. See how we built it.

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 connection provides 10 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Juggling 10 Tabs Just to See Project Statuses

Right now, checking project progress means clicking from your main dashboard into a specific Space. Then you might have to drill down through several parent Folders, and finally click the specific List that holds the work items. You copy status updates from one tab and paste them into another spreadsheet just to get a clean view of who owns what.

With this MCP, that clicking stops entirely. Your AI agent handles the entire navigation stack for you. It acts like it's logged in everywhere at once, pulling real-time data on task statuses and ownership directly into your conversation.

Control Every Element with the ClickUp MCP

Manual updates are a nightmare. If a priority changes or a description needs fixing, you have to find the exact task, click 'edit,' and manually save it. This process is slow and leaves no audit trail of who changed what.

Now, your agent lets you manage those elements with simple commands. You can tell it to `update_task` across several items or confirm a whole new structure using `list_spaces`. The control shifts from the interface buttons to your natural language input.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

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.

Built · Hosted · Managed by Vinkius ClickUp MCP - Manage Tasks and Projects with AI

Server ID 019dd0cf-8b50-72ac-8821-62562f38a64c

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

What Changes When You Connect

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.

See it in action

01 01

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.

02 02

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.

03 03

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.

04 04

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.

The honest tradeoffs

Trying to find a list deep in the structure.

Anti-pattern

Manually clicking through Workspaces > Spaces > Folders until you find the right List is slow, error-prone, and takes context switching time.

The Fix

Use list_workspaces first to narrow your scope. Then use list_folders or even just ask your agent to discover the path for you. Don't click; query.

Assuming a task exists by name.

Anti-pattern

Telling your agent, 'Update the 'Login Bug Fix' task.' If that title is duplicated or slightly misspelled, nothing happens, and you waste time checking multiple locations.

The Fix

Always run get_task_details first to confirm the exact task ID. Then use update_task with that verified ID for reliable execution.

Over-relying on one view.

Anti-pattern

Looking only at a specific 'Development' list and ignoring tasks in folderless lists (which might be critical).

The Fix

Always run list_folderless_lists to ensure you are checking the entire project surface, not just the parts tucked inside folders.

When It Fits, When It Doesn't

Use this MCP if your primary pain point is structural visibility and workflow automation. If you need to create tasks and read detailed records across a complex hierarchy of spaces, folders, lists, and workspaces, this tool is essential. Don't use it if all you need is simple message passing or basic file storage—you'll be better off with a dedicated communication MCP. Avoid using list_tasks alone; always combine it with list_lists first to know where the tasks are before trying to count them.

Questions you might have

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? +

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.

Connect to your AI in seconds.

Create task

Delete task

Get task details

ClickUp: 10 Tools for Complete Project Control

Make your AI actually useful.

Create Task

Delete Task

Get Task Details

List Folderless Lists

List Folders

List Lists

List Spaces

List Tasks

List Workspaces

Update Task

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Juggling 10 Tabs Just to See Project Statuses

Control Every Element with the ClickUp MCP

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

Auditing Project Scope

Mid-Sprint Status Check

Onboarding a New Team Member

Batch Updating Deliverables

The honest tradeoffs

Trying to find a list deep in the structure.

Assuming a task exists by name.

Over-relying on one view.

When It Fits, When It Doesn't

Questions you might have