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
