calcom-mcp-for-customers 1.0.0

Cal.com MCP server for interacting with the Cal.com API

Cal.com MCP Server for Customers

A FastMCP server that allows AI assistants and LLMs to interact with your Cal.com calendar. This enables AI to help your customers book meetings, check availability, and manage your scheduling directly through natural conversation.

Quick Start

The easiest way to use this MCP server is with uvx:

uvx run calcom-mcp-for-customers@latest stdio

What This Does

This MCP server gives AI assistants the ability to:

• Check your availability by listing your event types
• Book meetings on your calendar with customer details
• View existing bookings and their status
• Access your Cal.com schedules, teams, and users
• Manage webhooks for your Cal.com account

Setup Requirements

Before using this MCP server, you need:

1. A Cal.com account with API access

2. Your Cal.com API key (get it from your Cal.com settings → Developer section)

3. Set your API key as an environment variable:

   export CALCOM_API_KEY="your_actual_api_key_here"
   

Usage with AI Assistants

Once running, the MCP server provides these tools to AI assistants:

Booking Management

• create_booking() - Book new meetings with customer details
• get_bookings() - View existing bookings with filters
• list_event_types() - Show available meeting types

Account Information

• list_schedules() - View your availability schedules
• list_teams() - Access team information
• list_users() - View account users
• list_webhooks() - Manage webhook configurations

Status Check

• get_api_status() - Verify API key configuration

Transport Options

The server supports different connection methods:

• stdio - Standard input/output (most common)
• sse - Server-Sent Events (port 9557)
• streamable-http - HTTP streaming (port 9558)

Example AI Conversation

With this MCP server running, you can have conversations like:

You: "What meeting types do I have available?"

AI: Uses list_event_types() to show your Cal.com event types

You: "Book a 30-minute consultation with John Doe ([e-mail]) for tomorrow at 2 PM"

AI: Uses create_booking() to schedule the meeting and confirms the booking

Security Note

Keep your Cal.com API key secure! Never share it publicly or commit it to version control. Always use environment variables to store your API key.

Installation for Development

If you want to modify or contribute to this MCP server:

git clone https://github.com/Niopub/calcom-mcp-for-customers.git
cd calcom-mcp-for-customers
python -m venv .venv
source .venv/bin/activate
uv pip install -e .

License

This project is licensed under the MIT License - see the LICENSE file for details.