How to Use the ClickUp MCP in Mastra AI

Q: How do I register the ClickUp tools in Mastra AI?

You instantiate the MCPClient with the Vinkius URL and spread the returned tools into your Mastra agent's tool configuration. The framework automatically maps the schemas for execution.

Q: Can I require human approval before Mastra AI deletes a ClickUp task?

Yes, you can use Mastra's requireToolApproval middleware. This intercepts the deletetask tool call and pauses the workflow until a human operator approves the action.

Build resilient, self-healing ClickUp workflows with Mastra AI and this managed MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ClickUp MCP to Mastra AI

Create your Vinkius account to connect ClickUp to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ClickUp with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Task Creation Pipelines

The `create_task` tool allows your Mastra agent to spin up new work items based on external triggers like webhooks or database events. If the creation step fails due to network hiccups, Mastra's workflow engine retries the call automatically. You can configure conditional steps that check the task's status after creation. The agent uses this feedback loop to decide whether to assign team members or move the task to a different list.

Multi-tier ClickUp Folder Audits

The `list_folders` tool lets your background workflows scan through your spaces to find unorganized projects. Mastra AI can run this audit on a cron schedule, identifying empty folders that need cleanup. When the agent finds isolated tasks, it calls `list_folderless_lists` to locate a home for them. This keeps your project architecture clean without manual intervention.

Mastra AI State Synchronization

The `update_task` tool synchronizes your external databases with ClickUp in real-time. When a customer payment status changes, Mastra triggers this tool to update the corresponding task name or description. This MCP Server ensures that your internal tracking always matches reality. If a task needs to be archived, the workflow can call `delete_task` to purge obsolete records automatically.

Setup guide

Set up ClickUp MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All ClickUp tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "clickup-alternative-mcp-client",
  servers: {
    "clickup-alternative-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "ClickUp Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to ClickUp tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent ClickUp transactions"
);
console.log(result.text);

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ClickUp now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ClickUp MCP in Mastra AI

You instantiate the `MCPClient` with the Vinkius URL and spread the returned tools into your Mastra agent's tool configuration. The framework automatically maps the schemas for execution.

Yes, you can use Mastra's `requireToolApproval` middleware. This intercepts the `delete_task` tool call and pauses the workflow until a human operator approves the action.

Mastra's built-in retry engine with exponential backoff handles temporary rate limits seamlessly. If the ClickUp MCP Server returns a rate limit error, the workflow pauses and retries.

Absolutely. You can run Mastra AI locally on your machine while it connects to the secure, hosted MCP Server endpoint on Vinkius.

Your ClickUp tasks, lists, and workspace configurations are processed entirely within ephemeral Vinkius V8 isolates. No data is cached or stored, ensuring your corporate structure remains private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript