How to Use the Cal.com MCP in Claude Code

Manage your calendar from the command line. Claude Code handles scheduling and webhook audits directly in your terminal.

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

Headless scheduling via Claude Code

The `create_new_booking` tool in this MCP Server lets you schedule meetings without leaving your SSH session. You type a command to set up an incident review. The CLI checks your working hours via `list_availability_schedules` and fires off the calendar invite. This works perfectly in automated scripts. If an alert triggers in your infrastructure, you pipe that event into the agent. It runs `get_available_slots` and books a sync with the on-call engineer automatically.

Automate your webhook audits

The `list_active_webhooks` tool pulls your event routing configurations straight to standard output. You tell the CLI to audit your logging endpoints. It grabs the active URLs and formats them into a JSON report. You never touch a GUI. The agent calls `get_event_type_details` to map which templates trigger which webhooks. You pipe this data directly into your CI/CD pipeline to verify your environment matches production.

Manage the Cal.com MCP Server from the CLI

The `reschedule_meeting` tool shifts appointments directly from your prompt. You tell the terminal agent that a deployment is running late. It finds the upcoming sync using `list_bookings` and moves it back an hour. It handles cancellations just as fast. The agent executes `cancel_booking` to clear your schedule and sends the updated status to the terminal. You verify the token connection anytime with `test_cal_auth`.

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-alternative-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-alternative-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-alternative-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 the add command with the HTTP transport flag. Pass the server URL at the end of the string. The config saves automatically to your local settings file.

Yes. You pipe a prompt into the CLI asking for your free time. It executes the availability tool and outputs the raw time blocks to standard out.

You run the CLI headless inside your CI/CD runners. It authenticates using your endpoint token and executes calendar operations as part of your deployment jobs.

Prompt the terminal to list your event types. It fetches the active templates and prints their IDs and names directly to your console.

Vinkius isolates your webhook URLs and calendar blocks within an ephemeral sandbox. The execution context handles the API request and terminates immediately, leaving no residual data behind.

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