How to Use the Cal.com MCP in Vercel AI SDK

Q: Can Vercel AI SDK filter Cal.com bookings by status?

Yes. The agent calls listbookings to pull attendees and temporal slots. It filters by accepted, pending, cancelled, or rejected statuses before streaming the list to your frontend.

Q: What happens when an agent cancels a Cal.com meeting?

The cancelbooking tool frees the timeslot via secure UID matching. It then sends an automated email to both the guest and the organizer with the cancellation reason.

Build live scheduling interfaces in your React apps with the Cal.com MCP Server for Vercel AI SDK.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Cal.com availability directly via Vercel AI SDK

`get_available_slots` checks your free time blocks and returns the exact array bounds for mapped event types. Instead of making users wait behind a loading spinner, Vercel AI SDK streams this data straight into your Next.js frontend as the LLM fetches it. You build interfaces where timeslots appear in real-time. Call mcpClient.tools() and pass the results to streamText, letting your users see open calendar gaps the second the agent finds them.

Create and manage bookings on the fly

`create_booking` grabs host slots and generates conferencing URLs right inside your chat interface. When a user asks to lock in a time, the agent triggers the booking and the UI updates instantly. Need to change plans? The `reschedule_booking` and `cancel_booking` tools modify host structures and fire off email notifications to both organizers and guests. Everything happens within the conversational flow you built.

Pull schedule profiles and event formats

`get_me` grabs the authenticated user profile, pulling timezone, default schedule, and organization info. Your AI client uses this context to figure out who it is talking to before offering up times. Combine that with `list_event_types` to show users exactly what kind of meetings they can book. The tools map active formats, pushing structured scheduling types into your Vue or Svelte components without writing custom API wrappers.

Setup guide

Set up Cal.com MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Cal.com tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Cal.com transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Install @ai-sdk/mcp via npm. Initialize it using createMCPClient with your Vinkius HTTP transport URL, then pass mcpClient.tools() into your streamText call.

Yes. The agent calls list_bookings to pull attendees and temporal slots. It filters by accepted, pending, cancelled, or rejected statuses before streaming the list to your frontend.

You handle that through the authProvider config. The MCP client passes the token, letting the agent access get_me and user-specific schedules securely.

The cancel_booking tool frees the timeslot via secure UID matching. It then sends an automated email to both the guest and the organizer with the cancellation reason.

Vinkius runs the server in an ephemeral V8 Isolate Sandbox. When your agent pulls working hours via list_schedules, the connection drops immediately after the request, leaving zero data on our infrastructure.

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