Danielpeter-99/calcom-mcp

> ⚠️ **Disclaimer**: This project is not affiliated with or endorsed by Cal.com. I am an independent developer and have no association with Cal.com in any official capacity.
This project provides a FastMCP server for interacting with the Cal.com API. It allows Language Learning Models (LLMs) to use tools to connect with important Cal.com functionalities like managing event types and bookings.
Prerequisites
- Python 3.8+
- A Cal.com account and API Key (v2)
Setup
1. **Clone the repository (if applicable) or download the files.**
2. **Create a virtual environment (recommended):**
3. **Install dependencies:**
4. **Set up the Cal.com API Key:**
You need to set the CALCOM_API_KEY environment variable. You can get your API key from your Cal.com settings page (usually under Developer or Security settings).
- **Linux/macOS:**
To make it permanent, add this line to your shell configuration file (e.g., .bashrc, .zshrc).
- **Windows (PowerShell):**
To make it permanent, you can set it through the System Properties > Environment Variables.
Running the Server
Once the setup is complete, you can run the FastMCP server:
The server will start at localhost:8010, and you should see output indicating it's running. If the CALCOM_API_KEY is not set, a warning will be displayed.
Available Tools
The server currently provides the following tools for LLM interaction:
- get_api_status(): Check if the Cal.com API key is configured in the environment. Returns a string indicating the status.
- list_event_types(): Fetch a list of all event types from Cal.com for the authenticated account. Returns a dictionary with the list of event types or an error message.
- get_bookings(...): Fetch a list of bookings from Cal.com, with optional filters (event_type_id, user_id, status, date_from, date_to, limit). Returns a dictionary with the list of bookings or an error message.
- create_booking(...): Create a new booking in Cal.com for a specific event type and attendee. Requires parameters like start_time, attendee details, and event type identifiers. Returns a dictionary with booking details or an error message.
- list_schedules(...): List all schedules available to the authenticated user or for a specific user/team. Optional filters: user_id, team_id, limit. Returns a dictionary with the list of schedules or an error message.
- list_teams(...): List all teams available to the authenticated user. Optional filter: limit. Returns a dictionary with the list of teams or an error message.
- list_users(...): List all users available to the authenticated account. Optional filter: limit. Returns a dictionary with the list of users or an error message.
- list_webhooks(...): List all webhooks configured for the authenticated account. Optional filter: limit. Returns a dictionary with the list of webhooks or an error message.
**Note:** All tools require the CALCOM_API_KEY environment variable to be set. If it is not set, tools will return a structured error message.