Calendly MCP Server

A Model Context Protocol (MCP) server for integrating with the Calendly API. This server provides tools to interact with Calendly's scheduling platform, allowing you to retrieve user information, list events, manage invitees, cancel events, and schedule meetings directly via the new Scheduling API.

Features

Core Calendly Integration

• User Information: Get current authenticated user details
• Event Management: List, retrieve, and cancel scheduled events
• Invitee Management: List and manage event invitees
• Organization: List organization memberships

NEW: Scheduling API Integration

• Direct Meeting Scheduling: Book meetings programmatically without redirects
• Event Type Discovery: List available event types for scheduling
• Real-Time Availability: Check available time slots for any event type
• Complete Booking Flow: End-to-end scheduling with calendar sync and notifications
• Location Support: Zoom, Google Meet, Teams, physical locations, and custom options

Installation

Option 1: NPX (Recommended)

Run directly without installation:

npx calendly-mcp-server

Option 2: Manual Installation

1. Clone this repository:

git clone https://github.com/meAmitPatil/calendly-mcp-server.git
cd calendly-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

Authentication

This server supports two authentication methods:

Option 1: Personal Access Token (PAT)

For internal applications or personal use:

1. Get your Personal Access Token from your Calendly Integrations page
2. Select API and webhooks → Get a token now
3. Set the environment variable:

export CALENDLY_API_KEY="your_personal_access_token_here"

Option 2: OAuth 2.0

For public applications that multiple users will use:

1. Create a developer account at developer.calendly.com
2. Create an OAuth application to get your client credentials
3. Set the environment variables:

export CALENDLY_CLIENT_ID="your_client_id_here"
export CALENDLY_CLIENT_SECRET="your_client_secret_here"

4. Optionally, if you already have tokens:

export CALENDLY_ACCESS_TOKEN="your_access_token_here"
export CALENDLY_REFRESH_TOKEN="your_refresh_token_here"

Optional User Context (Recommended)

For better performance and automatic defaults, you can set user-specific URIs:

export CALENDLY_USER_URI="https://api.calendly.com/users/your_user_id"
export CALENDLY_ORGANIZATION_URI="https://api.calendly.com/organizations/your_org_id"

These can be obtained by running get_current_user after authentication. When set, the server will automatically use these as defaults for API calls that require user context.

MCP Configuration

Add the server to your MCP client configuration (e.g., Claude Desktop):

Option 1: Using NPX (Recommended)

For Personal Access Token:

{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["calendly-mcp-server"],
      "env": {
        "CALENDLY_API_KEY": "your_personal_access_token_here",
        "CALENDLY_USER_URI": "https://api.calendly.com/users/your_user_id",
        "CALENDLY_ORGANIZATION_URI": "https://api.calendly.com/organizations/your_org_id"
      }
    }
  }
}

For OAuth 2.0:

{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["calendly-mcp-server"],
      "env": {
        "CALENDLY_CLIENT_ID": "your_client_id_here",
        "CALENDLY_CLIENT_SECRET": "your_client_secret_here",
        "CALENDLY_ACCESS_TOKEN": "your_access_token_here",
        "CALENDLY_REFRESH_TOKEN": "your_refresh_token_here",
        "CALENDLY_USER_URI": "https://api.calendly.com/users/your_user_id",
        "CALENDLY_ORGANIZATION_URI": "https://api.calendly.com/organizations/your_org_id"
      }
    }
  }
}


... [View full README on GitHub](https://github.com/meAmitPatil/calendly-mcp-server#readme)