Calendly MCP Server

Complete Model Context Protocol (MCP) server for Calendly API v2 with 40+ tools and 12 interactive React apps.

Features

• ✅ 40+ MCP Tools covering all Calendly API endpoints

• ✅ 12 React Apps for interactive workflows

• ✅ Full TypeScript with comprehensive type definitions

• ✅ OAuth2 & API Key authentication support

• ✅ Rate Limiting and error handling

• ✅ Dual Transport (stdio and HTTP)

Installation

npm install @busybee3333/calendly-mcp

Configuration

Set one of the following environment variables:

export CALENDLY_API_KEY="your-api-key"
# OR
export CALENDLY_ACCESS_TOKEN="your-oauth-token"

Get Your API Key

1. Go to Calendly Integrations

2. Navigate to API & Webhooks

3. Generate a Personal Access Token

Usage

Stdio Transport (for Claude Desktop, etc.)

calendly-mcp

Programmatic Usage

import { createCalendlyServer } from '@busybee3333/calendly-mcp';

const server = createCalendlyServer({
  apiKey: process.env.CALENDLY_API_KEY,
});

MCP Tools (40+)

Users (2 tools)

Organizations (8 tools)

Event Types (5 tools)

Scheduled Events (3 tools)

Invitees (5 tools)

Webhooks (4 tools)

Scheduling (1 tool)

Routing Forms (4 tools)

Availability (2 tools)

Data Compliance (3 tools)

MCP Apps (12 Interactive React Apps)

1. Event Type Dashboard

Purpose: Manage your Calendly event types
Features:

• View all event types in a grid layout

• Toggle active/inactive status

• Quick access to scheduling URLs

• Shows duration, type, and description

2. Calendar View

Purpose: View your scheduled events in a list format
Features:

• Filter by time range (week/month)

• Group events by date

• Show event status, location, and invitee count

• Time-formatted display

3. Invitee Grid

Purpose: View and manage event invitees
Features:

• Select events from dropdown

• Table view of all invitees

• Mark invitees as no-shows

• Show status, timezone, and reschedule info

4. Webhook Manager

Purpose: Manage Calendly webhook subscriptions
Features:

• Create new webhooks with event selection

• View all active webhooks

• Delete webhooks

• Shows callback URLs and event types

5. Organization Overview

Purpose: Manage your organization
Features:

• View organization details

• List all members with roles

• Manage pending invitations

• Revoke invitations

6. User Profile

Purpose: View your Calendly profile and settings
Features:

• Display user information

• Show avatar and scheduling URL

• List availability schedules

• Show schedule rules and timezones

7. Analytics Dashboard

Purpose: Overview of your Calendly metrics
Features:

• Total events count

• Active vs canceled events

• Total invitees

• Event types count

• No-shows tracking

8. Availability Manager

Purpose: Manage your availability schedules
Features:

• View all availability schedules

• Show weekly rules with time slots

• Display timezone information

• Highlight default schedule

9. Event Detail View

Purpose: View detailed information about events
Features:

• Select and view specific events

• Show all event metadata

• List all invitees

• Cancel events

10. No-Show Tracker

Purpose: Track and manage no-show invitees
Features:

• List all no-shows across events

• Show event and invitee details

• Remove no-show markings

• Display no-show count

11. Routing Form Builder

Purpose: Manage routing forms and view submissions
Features:

• List all routing forms

• View form questions and structure

• Show all submissions

• Display routing results

12. Scheduling Link Manager

Purpose: Generate single-use scheduling links
Features:

• Select event type

• Set maximum event count

• Generate unique booking URLs

• Copy links to clipboard

Examples

List Event Types

const result = await callTool('calendly_list_event_types', {
  user: 'https://api.calendly.com/users/AAAA',
  active: true
});

Create Event Type

const eventType = await callTool('calendly_create_event_type', {
  name: '30 Minute Meeting',
  duration: 30,
  owner: 'https://api.calendly.com/users/AAAA',
  description_plain: 'A quick 30-minute chat',
  color: '#0066cc'
});

List Upcoming Events

const events = await callTool('calendly_list_events', {
  user: 'https://api.calendly.com/users/AAAA',
  min_start_time: new Date().toISOString(),
  status: 'active',
  sort: 'start_time:asc'
});

Create Webhook

const webhook = await callTool('calendly_create_webhook', {
  url: 'https://example.com/webhook',
  events: ['invitee.created', 'invitee.canceled'],
  organization: 'https://api.calendly.com/organizations/AAAA',
  scope: 'organization'
});

Generate Scheduling Link

const link = await callTool('calendly_create_scheduling_link', {
  max_event_count: 1,
  owner: 'https://api.calendly.com/event_types/AAAA',
  owner_type: 'EventType'
});

API Coverage

This MCP server covers 100% of Calendly API v2 endpoints:

• ✅ Users

• ✅ Organizations (Invitations, Memberships)

• ✅ Event Types (Full CRUD)

• ✅ Scheduled Events

• ✅ Invitees

• ✅ No-Shows

• ✅ Webhooks

• ✅ Scheduling Links

• ✅ Routing Forms & Submissions

• ✅ User Availability Schedules

• ✅ Activity Logs

• ✅ Data Compliance (GDPR)

Development

Build

npm run build

Test

npm test

Development Mode

npm run dev

Architecture

src/
├── server.ts              # MCP server setup
├── main.ts                # Entry point
├── clients/
│   └── calendly.ts        # Calendly API client
├── tools/                 # Tool definitions by domain
│   ├── users-tools.ts
│   ├── organizations-tools.ts
│   ├── event-types-tools.ts
│   ├── events-tools.ts
│   ├── invitees-tools.ts
│   ├── webhooks-tools.ts
│   ├── scheduling-tools.ts
│   ├── routing-forms-tools.ts
│   ├── availability-tools.ts
│   └── compliance-tools.ts
├── types/
│   └── index.ts           # TypeScript interfaces
└── ui/
    └── react-app/         # React apps
        ├── src/
        │   ├── apps/      # Individual apps
        │   ├── components/ # Shared components
        │   ├── hooks/     # Shared hooks
        │   └── styles/    # Shared styles
        └── package.json

License

MIT

Support

For issues or questions:

• GitHub: BusyBee3333/mcpengine

• Calendly API Docs: https://developer.calendly.com

Contributing

Contributions welcome! Please open an issue or PR.

Built with ❤️ using the Model Context Protocol