calendly – OpenClaw Skill

---

name: calendly description: Calendly scheduling integration. List events, check availability, manage meetings via Calendly API.

Calendly Skill

Interact with Calendly scheduling via MCP-generated CLI.

Note: Scheduling API features (list-event-types, get-event-type-availability, schedule-event) will be available once calendly-mcp-server v2.0.0 is published to npm. Current CLI uses v1.0.0 for portability.

Quick Start

# Get your Calendly profile (returns user URI)
calendly get-current-user

# List RECENT events (always use --min-start-time for recent queries!)
calendly list-events --user-uri "<YOUR_USER_URI>" --min-start-time "2026-01-20T00:00:00Z"

# Get event details
calendly get-event --event-uuid <UUID>

# Cancel an event
calendly cancel-event --event-uuid <UUID> --reason "Rescheduling needed"

Available Commands

User Info

• get-current-user - Get authenticated user details

Events

• list-events - List scheduled events (requires --user-uri)
• get-event - Get event details (requires --event-uuid)
• cancel-event - Cancel an event (requires --event-uuid, optional --reason)

Invitees

• list-event-invitees - List invitees for an event (requires --event-uuid)

Organization

• list-organization-memberships - List organization memberships

Configuration

API key can be stored in your environment or .env file:

export CALENDLY_API_KEY="<your-pat-token>"
# Or in ~/.moltbot/.env or ~/.clawdbot/.env

Get your Personal Access Token from: https://calendly.com/integrations/api_webhooks

Usage in Moltbot

When user asks about:

• "What meetings do I have?" → list-events with --min-start-time (use recent date!)
• "Cancel my 2pm meeting" → Find with list-events (time-filtered), then cancel-event
• "Who's attending X meeting?" → list-event-invitees

Note: First time, run calendly get-current-user to obtain your User URI.

Getting Your User URI

Run calendly get-current-user to get your user URI. Example:

{
  "resource": {
    "uri": "https://api.calendly.com/users/<YOUR_USER_UUID>",
    "scheduling_url": "https://calendly.com/<your-username>"
  }
}

Examples

# List next 10 events
calendly list-events \
  --user-uri "<YOUR_USER_URI>" \
  -o json | jq .

# Get event details
calendly get-event \
  --event-uuid "<EVENT_UUID>" \
  -o json

# Cancel with reason
calendly cancel-event \
  --event-uuid "<EVENT_UUID>" \
  --reason "Rescheduling due to conflict"

Coming Soon: Scheduling API (v2.0)

Once calendly-mcp-server v2.0.0 is published, these commands will be available:

Scheduling Workflow

# 1. List available event types
calendly list-event-types

# 2. Check availability for a specific event type
calendly get-event-type-availability --event-type "<EVENT_TYPE_URI>"

# 3. Schedule a meeting (requires paid Calendly plan)
calendly schedule-event \
  --event-type "<EVENT_TYPE_URI>" \
  --start-time "2026-01-25T19:00:00Z" \
  --invitee-email "client@company.com" \
  --invitee-name "John Smith" \
  --invitee-timezone "America/New_York"

Scheduling API Requirements:

• calendly-mcp-server v2.0.0+ (unreleased as of 2026-01-21)
• Paid Calendly plan (Standard or higher)

To upgrade when v2.0 is published:

cd ~/clawd/skills/calendly
MCPORTER_CONFIG=./mcporter.json npx mcporter@latest generate-cli --server calendly --output calendly

Important: Time Filtering

Always use --min-start-time when querying recent events!

The API returns events oldest-first by default and doesn't support pagination via CLI. Without a time filter, you'll get events from years ago.

# Last 7 days
calendly list-events --user-uri "<URI>" --min-start-time "$(date -u -d '7 days ago' +%Y-%m-%dT00:00:00Z)"

# This week
calendly list-events --user-uri "<URI>" --min-start-time "2026-01-20T00:00:00Z" --max-start-time "2026-01-27T23:59:59Z"

# Future events only
calendly list-events --user-uri "<URI>" --min-start-time "$(date -u +%Y-%m-%dT%H:%M:%SZ)"

Notes

• All times in API responses are UTC (convert to Pacific for display)
• Event UUIDs are found in list-events output
• OAuth tools available but not needed with Personal Access Token
• No pagination support in CLI - use time filters instead

---

Generated: 2026-01-20
Updated: 2026-01-21 (Portable CLI with npm v1.0.0; v2.0 scheduling features pending upstream publish)
Source: meAmitPatil/calendly-mcp-server via mcporter

Calendly Moltbot Skill

Moltbot skill for Calendly integration. List events, check availability, manage meetings via the Calendly API.

Features

• User Info: Get authenticated user details
• Event Management: List, view, and cancel scheduled events
• Invitee Management: View event invitees
• Organization: List organization memberships

Note: Scheduling API features (list-event-types, get-event-type-availability, schedule-event) are available in calendly-mcp-server v2.0.0, which is currently unreleased. This skill uses v1.0.0 from npm for portability. See Upgrade to v2.0 for instructions once published.

Installation

# Clone the repo
git clone https://github.com/kesslerio/calendly-moltbot-skill.git
cd calendly-moltbot-skill

# The CLI is self-contained (generated via mcporter from MCP server)
chmod +x calendly

Configuration

Add your Calendly Personal Access Token to your environment:

export CALENDLY_API_KEY="your-pat-token"

Get your token from: https://calendly.com/integrations/api_webhooks

Usage

Get Your Profile

./calendly get-current-user

List Events

./calendly list-events --user-uri "<YOUR_USER_URI>"

Get Event Details

./calendly get-event --event-uuid "<EVENT_UUID>"

Cancel Event

./calendly cancel-event --event-uuid "<EVENT_UUID>" --reason "Rescheduling needed"

Available Commands

Event Management

• get-current-user - Get authenticated user details
• list-events - List scheduled events
• get-event - Get event details
• cancel-event - Cancel an event
• list-event-invitees - List invitees for an event
• list-organization-memberships - List organization memberships

OAuth

• get-oauth-url - Generate OAuth authorization URL
• exchange-code-for-tokens - Exchange authorization code for tokens
• refresh-access-token - Refresh access token

Integration with Moltbot

Add to your Moltbot skills configuration:

# Copy or symlink to your Moltbot skills directory
ln -s $(pwd) /path/to/your/moltbot/skills/calendly

# Or add to your moltbot.json config:
{
  "skills": [
    {
      "name": "calendly",
      "path": "/path/to/calendly-moltbot-skill"
    }
  ]
}

Then use in conversations:

• "What meetings do I have?"
• "Cancel my 2pm meeting"
• "Who's attending my next call?"

Upgrade to v2.0

Once calendly-mcp-server v2.0.0 is published to npm (adds Scheduling API with event types, availability, and programmatic scheduling), regenerate the CLI:

# Update to v2.0+
MCPORTER_CONFIG=./mcporter.json npx mcporter@latest generate-cli --server calendly --output calendly

# Verify new commands appear
./calendly --help | grep -E "list-event-types|get-event-type-availability|schedule-event"

The v2.0 Scheduling API will add:

• list-event-types - List available event types for scheduling
• get-event-type-availability - Get available time slots
• schedule-event - Schedule meetings programmatically

Requires: Paid Calendly plan (Standard or higher)

Development

This skill wraps the calendly-mcp-server MCP server via mcporter.

To regenerate the CLI (if the upstream MCP server updates):

# Uses mcporter.json config (not tracked in git)
cat > mcporter.json <<EOF
{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["-y", "calendly-mcp-server"],
      "env": {
        "CALENDLY_API_KEY": "\${CALENDLY_API_KEY}"
      }
    }
  }
}
EOF

# Generate CLI
MCPORTER_CONFIG=./mcporter.json npx mcporter@latest generate-cli --server calendly --output calendly

License

MIT

Credits

• MCP Server: meAmitPatil/calendly-mcp-server
• CLI Generator: mcporter
• Moltbot: moltbot.io