How to Use the Cal.com MCP in Mastra AI

Q: How do I configure Cal.com tool approvals in Mastra AI?

You use Mastra's requireToolApproval configuration when registering the Cal.com MCP Server tools. When the agent attempts to run cancelbooking, the workflow pauses and emits an approval event. The action only executes after you programmatically approve it.

Q: What is the setup process for Cal.com with Mastra AI?

Install the package using npm install @mastra/mcp@latest to begin setting up Cal.com with Mastra AI. Then, initialize a new MCPClient pointing to the Vinkius URL for your Cal.com MCP Server. Finally, spread the retrieved tools into your Mastra agent's tool configuration.

Automate complex Cal.com booking workflows with Mastra AI's resilient agent framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cal.com MCP to Mastra AI

Create your Vinkius account to connect Cal.com 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 Cal.com with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build multi-step scheduling workflows with Mastra AI

By exposing `get_schedules` and `create_booking`, this MCP Server lets Mastra AI run conditional scheduling logic that won't break when APIs hiccup. If the booking fails because the slot was taken, Mastra's workflow engine retries with backoff or branches to offer an alternative slot. You can also chain actions together, like calling `list_memberships` after a successful booking to assign the right team member.

Human-in-the-loop approvals for this MCP Server

With `cancel_booking` and `create_event_type` active, this MCP Server lets you enforce human-in-the-loop approval before executing sensitive calendar changes. Mastra AI lets you pause execution and wait for a green light before modifying any Cal.com schedules. Once you click approve, Mastra resumes the workflow and completes the booking update.

Automated team onboarding and setup

Integrating `get_current_user` and `list_memberships` allows this MCP Server to let your Mastra AI agent verify a new hire's profile and organization status. By running `create_event_type` programmatically, the agent provisions the correct booking links for the new hire. This entire sequence runs as a background task, ensuring every team member gets a uniform schedule setup.

Setup guide

Set up Cal.com 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 Cal.com 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: "calcom-mcp-client",
  servers: {
    "calcom-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Cal.com 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 Cal.com. 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 Cal.com 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 Cal.com MCP in Mastra AI

You use Mastra's `requireToolApproval` configuration when registering the Cal.com MCP Server tools. When the agent attempts to run `cancel_booking`, the workflow pauses and emits an approval event. The action only executes after you programmatically approve it.

Yes, Mastra AI has built-in exponential backoff for tool executions to handle Cal.com API limits. If a call to `list_bookings` hits Cal.com rate limits, the framework automatically pauses and retries the request. This prevents your background scheduling workflows from failing due to temporary network issues.

Install the package using `npm install @mastra/mcp@latest` to begin setting up Cal.com with Mastra AI. Then, initialize a new `MCPClient` pointing to the Vinkius URL for your Cal.com MCP Server. Finally, spread the retrieved tools into your Mastra agent's tool configuration.

Yes, Mastra's built-in workflow engine allows you to trigger Cal.com agent runs on a schedule. You can set up a daily job that calls `list_bookings` to scan for upcoming conflicts and resolve them automatically.

Absolutely. Vinkius hosts the MCP Server in a zero-trust, ephemeral sandbox environment where data is processed strictly in-memory. Your calendar bookings and user schedules are never cached, saved to disk, or exposed to third parties. All traffic is fully encrypted end-to-end, keeping your team's schedules secure.

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