Danielpeter-99 · Matvey-Kuk · Aug 15, 2025
diff --git a/README.md b/README.md
@@ -1,94 +1,96 @@
-# Cal.com FastMCP Server
-
-> ⚠️ **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.**
-    ```bash
-    git clone https://github.com/Danielpeter-99/calcom-mcp.git
-    cd calcom-mcp
-    ```
-
-2.  **Create a virtual environment (recommended):**
-    ```bash
-    python -m venv venv
-    source venv/bin/activate  # On Windows: venv\Scripts\activate
-    ```
-
-3.  **Install dependencies:**
-    ```bash
-    pip install -r requirements.txt
-    ```
-
-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:**
-        ```bash
-        export CALCOM_API_KEY="your_actual_api_key_here"
-        ```
-        To make it permanent, add this line to your shell configuration file (e.g., `.bashrc`, `.zshrc`).
-
-    -   **Windows (PowerShell):**
-        ```powershell
-        $env:CALCOM_API_KEY="your_actual_api_key_here"
-        ```
-        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:
-
-```bash
-fastmcp run app.py --transport sse --port 8010
-```
-
-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.
-
-## Tool Usage and Error Handling
-
-- All tools return either the API response (as a dictionary or string) or a structured error message with details about the failure.
-- Error messages include the type of error, HTTP status code (if applicable), and the response text from the Cal.com API.
-- For best results, always check for the presence of an `error` key in the response before using the returned data.
-- Tools are designed to be robust and provide informative feedback for both successful and failed API calls.
-
-## Development Notes
-
--   The Cal.com API base URL is set to `https://api.cal.com/v2`.
--   Authentication is primarily handled using a Bearer token with the `CALCOM_API_KEY`.
--   The `create_booking` tool uses the `cal-api-version: 2024-08-13` header as specified in the Cal.com API v2 documentation for that endpoint.
--   Error handling is included in the API calls to provide informative responses.
-
-## 🚀 Built With
-
-[![Python](https://img.shields.io/badge/Python-3.8+-blue?logo=python&logoColor=white)](https://www.python.org/)  
-[![FastMCP](https://img.shields.io/badge/FastMCP-Framework-8A2BE2?logo=fastapi&logoColor=white)](https://github.com/jlowin/fastmcp)  
-[![Cal.com API](https://img.shields.io/badge/Cal.com%20API-v2-00B8A9?logo=google-calendar&logoColor=white)](https://cal.com/docs/api-reference/v2/introduction)  
-
-
-## Important Security Note
-
-**Never hardcode your `CALCOM_API_KEY` directly into the source code.** Always use environment variables as described in the setup instructions to keep your API key secure.
+# Cal.com FastMCP Server
+
+> ⚠️ **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.**
+    ```bash
+    git clone https://github.com/Danielpeter-99/calcom-mcp.git
+    cd calcom-mcp
+    ```
+
+2.  **Create a virtual environment (recommended):**
+    ```bash
+    python -m venv venv
+    source venv/bin/activate  # On Windows: venv\Scripts\activate
+    ```
+
+3.  **Install dependencies:**
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+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:**
+        ```bash
+        export CALCOM_API_KEY="your_actual_api_key_here"
+        ```
+        To make it permanent, add this line to your shell configuration file (e.g., `.bashrc`, `.zshrc`).
+
+    -   **Windows (PowerShell):**
+        ```powershell
+        $env:CALCOM_API_KEY="your_actual_api_key_here"
+        ```
+        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:
+
+```bash
+fastmcp run app.py --transport sse --port 8010
+```
+
+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.
+
+## Tool Usage and Error Handling
+
+- All tools return either the API response (as a dictionary or string) or a structured error message with details about the failure.
+- Error messages include the type of error, HTTP status code (if applicable), and the response text from the Cal.com API.
+- For best results, always check for the presence of an `error` key in the response before using the returned data.
+- Tools are designed to be robust and provide informative feedback for both successful and failed API calls.
+
+## Development Notes
+
+-   The Cal.com API base URL is set to `https://api.cal.com/v2`.
+-   Authentication is primarily handled using a Bearer token with the `CALCOM_API_KEY`.
+-   The `create_booking` tool uses the `cal-api-version: 2024-08-13` header as specified in the Cal.com API v2 documentation for that endpoint.
+-   Error handling is included in the API calls to provide informative responses.
+
+## 🚀 Built With
+
+[![Python](https://img.shields.io/badge/Python-3.8+-blue?logo=python&logoColor=white)](https://www.python.org/)  
+[![FastMCP](https://img.shields.io/badge/FastMCP-Framework-8A2BE2?logo=fastapi&logoColor=white)](https://github.com/jlowin/fastmcp)  
+[![Cal.com API](https://img.shields.io/badge/Cal.com%20API-v2-00B8A9?logo=google-calendar&logoColor=white)](https://cal.com/docs/api-reference/v2/introduction)  
+
+[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/Danielpeter-99/calcom-mcp)](https://archestra.ai/mcp-catalog/danielpeter-99__calcom-mcp)
+
+
+## Important Security Note
+
+**Never hardcode your `CALCOM_API_KEY` directly into the source code.** Always use environment variables as described in the setup instructions to keep your API key secure.