Calendly MCP Server

Fork of meAmitPatil/calendly-mcp-server with Scheduling API integration and OAuth 2.0 support.

A Model Context Protocol (MCP) server for the Calendly API. Manage events, invitees, and schedule meetings directly via AI assistants.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["-y", "calendly-mcp-server"],
      "env": {
        "CALENDLY_API_KEY": "your_personal_access_token_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["-y", "calendly-mcp-server"],
      "env": {
        "CALENDLY_API_KEY": "your_personal_access_token_here"
      }
    }
  }
}

Configuration

Variable	Required	Description
CALENDLY_API_KEY	Yes*	Personal Access Token (get one here)
CALENDLY_CLIENT_ID	Yes*	OAuth 2.0 client ID (alternative to PAT)
CALENDLY_CLIENT_SECRET	Yes*	OAuth 2.0 client secret
CALENDLY_ACCESS_TOKEN	No	OAuth access token (if already obtained)
CALENDLY_REFRESH_TOKEN	No	OAuth refresh token
CALENDLY_USER_URI	No	User URI for automatic defaults
CALENDLY_ORGANIZATION_URI	No	Organization URI for automatic defaults

*Either CALENDLY_API_KEY or OAuth credentials (CALENDLY_CLIENT_ID + CALENDLY_CLIENT_SECRET) are required.

Tools (12)

OAuth

Tool	Description
get_oauth_url	Generate OAuth authorization URL
exchange_code_for_tokens	Exchange authorization code for tokens
refresh_access_token	Refresh an expired access token

API

Tool	Description
get_current_user	Get authenticated user info
list_events	List scheduled events with filtering
get_event	Get event details
list_event_invitees	List invitees for an event
cancel_event	Cancel a scheduled event
list_organization_memberships	List organization memberships

Scheduling API

Tool	Description
list_event_types	List available event types
get_event_type_availability	Check available time slots
schedule_event	Book a meeting (requires paid Calendly plan)

API Limitations

• Scheduling API requires a paid Calendly plan (Standard or higher)
• Event rescheduling is not supported via API (only cancellation)
• Event type creation is not available via API
• Standard Calendly API rate limits apply

Contributing

Pull requests welcome. See the upstream project for the original implementation.

License

MIT License. See LICENSE for details.

Credits

• Original implementation by Amit Patil
• Fork maintained by 84em.io