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

Q: How do I check if the connection works?

Run the testcalauth tool before executing any complex logic. This verifies your API credentials are valid. It prevents runtime errors during user interactions.

Give your Vercel AI SDK applications the ability to book meetings and read calendar slots in real-time using this MCP integration.

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

Build live booking UIs with this MCP Server

Your React or Next.js frontend needs to show available times without making users wait. Using `get_available_slots`, the AI fetches open calendar blocks and streams them directly into your UI components. The end user sees open slots pop up instantly. Scheduling happens just as fast. When a user picks a time, `create_new_booking` fires off the request. You can confirm the appointment visually while the backend handles the calendar sync.

Manage existing appointments dynamically

Plans change, and your users expect a quick way to adapt. Passing the `reschedule_meeting` tool to your stream functions lets the agent handle date swaps conversationally. The system finds the original event using `get_booking_details` and updates the slot. Cancellations work exactly the same way. The `cancel_booking` function removes the meeting and frees up your schedule. Your app reflects the newly available time immediately.

Read scheduling rules and webhooks

Complex scheduling requires knowing the rules before offering slots. The agent reads `list_availability_schedules` to understand your working hours. It then checks `get_event_type_details` to see if a specific template requires a 30-minute or 60-minute window. You also get full visibility into backend triggers. Calling `list_active_webhooks` pulls current event configurations. This helps developers verify that booking confirmations actually reach their CRM or email service.

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 the required packages and initialize the MCP client using createMCPClient. Pass the HTTP transport URL provided by Vinkius. Call the tools method and feed that array into your generation functions.

Yes, the tool execution results stream live to the frontend. When the agent triggers a new booking, the UI updates instantly. Users never stare at a loading spinner while the calendar syncs.

You can configure an auth provider when setting up the client. This allows secure, user-specific authentication for scheduling actions. Make sure to close the connection when the session ends.

Run the test_cal_auth tool before executing any complex logic. This verifies your API credentials are valid. It prevents runtime errors during user interactions.

Vinkius runs the server in an ephemeral V8 Isolate Sandbox. Your attendee emails, meeting notes, and booking schedules never touch our disk. The zero-trust architecture destroys the environment the second your session ends.

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