How to Use the Cal.com MCP in Claude Code

Q: How do I add the Cal.com MCP Server to Claude Code?

Run claude mcp add --transport http calcom -- in your terminal. Make sure to put all transport flags before the server name, then verify it with claude mcp list.

Q: How does Claude Code handle Cal.com video link generation?

When you run createbooking, the server automatically generates video conferencing links if your event template specifies them. The agent then prints the join link directly to your terminal.

Q: Can I view my profile settings?

Yes. Use getme to check your active profile, default timezone, and organization details right in your shell.

Control your Cal.com schedule directly from the terminal with Claude Code.

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 Claude Code

Create your Vinkius account to connect Cal.com to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe Cal.com booking data with the MCP Server

This MCP Server lets you script your calendar from the command line. You can call `list_bookings` to dump your meetings as raw data and pipe them into other CLI utilities for reporting. Your agent can parse this output to find specific attendees, check meeting statuses, or grab video links. It gives you a fast, headless way to manage your day without opening a web browser.

Fast meeting management via Claude Code

Need to move a meeting quickly? You don't need a GUI. Claude Code uses `get_booking` to pull the event details and `reschedule_booking` to shift the time slot instantly. If a meeting falls through, your agent runs `cancel_booking` to free up the slot. It handles the cleanup and sends out the cancellation emails directly from your terminal session.

Query availability and event types instantly

You can check your availability without leaving your current shell. The agent uses `get_available_slots` to pull your free times and maps them against your templates via `list_event_types`. This is perfect for quickly sharing open slots in a chat or double-checking your setup. It pulls the raw configuration using `get_event_type` so you know exactly what rules are active.

Setup guide

Set up Cal.com MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see calcom-1-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Cal.com transactions." It will automatically discover and invoke the available Cal.com tools.

Terminal

claude mcp add --transport http calcom-1-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Cal.com MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "calcom-1-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Claude Code

Run `claude mcp add --transport http calcom -- ` in your terminal. Make sure to put all transport flags before the server name, then verify it with `claude mcp list`.

Yes. Because Claude Code is a terminal-based tool, you can run it in headless environments to execute calendar updates, check availability, or clean up test bookings.

When you run `create_booking`, the server automatically generates video conferencing links if your event template specifies them. The agent then prints the join link directly to your terminal.

Yes. Use `get_me` to check your active profile, default timezone, and organization details right in your shell.

All transport happens over HTTPS using Vinkius's zero-trust gateway. Your calendar configuration and timezone data are never cached on the local machine or exposed in cleartext.

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