@openpets/cal

Cal.com Pet

Cal.com plugin providing access to bookings, schedules, teams, and organization management through the Cal.com API v2.

Features

• 266 auto-generated tools from the Cal.com OpenAPI specification
• Full access to Cal.com API v2 endpoints
• Bookings management (create, reschedule, cancel)
• Schedules and availability management
• Team and organization management
• Event types configuration
• Webhooks and integrations
• OAuth client management

Setup

1. Get Your API Key

• Go to Cal.com API Keys Settings
• Create a new API key
• Copy the key (starts with cal_live_ or cal_test_)

2. Configure Environment

Create a .env file in your project root:

CAL_API_KEY=cal_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. Test Connection

opencode run "test cal connection"

Available Tools

The Cal.com pet provides 266 tools organized into categories:

Bookings (17 tools)

• Get all bookings
• Create booking
• Reschedule booking
• Cancel booking
• Mark no-show
• Get booking recordings & transcripts

Event Types (11 tools)

• List event types
• Create/update/delete event types
• Manage private links
• Configure webhooks

Schedules (12 tools)

• Get user schedules
• Create/update/delete schedules
• Get default schedule
• Manage availability

Teams (22 tools)

• List/create/update/delete teams
• Manage team memberships
• Team event types
• Team bookings

Organizations (120+ tools)

• Organization attributes
• Organization memberships
• Organization teams
• Routing forms
• Workflows
• Roles & permissions

OAuth & Platform (18 tools)

• Manage OAuth clients
• Platform user management
• Webhooks

Calendars & Conferencing (18 tools)

• Calendar integrations
• Conferencing apps
• Busy time lookup

Example Queries

# Get user information
opencode run "get my cal.com user details"

# List all bookings
opencode run "show me all my cal bookings"

# Get schedules
opencode run "list my cal schedules"

# List teams
opencode run "show my cal teams"

# Get event types
opencode run "list my event types"

# Create a booking
opencode run "create a cal booking for tomorrow at 2pm"

Advanced Configuration

Custom API Host

If you're using a self-hosted Cal.com instance:

CAL_HOST=https://your-cal-instance.com

Tool Categories

The 266 generated tools cover these major areas:

Category	Tools	Description
Orgs / Attributes	14	Organization custom attributes
Orgs / Bookings	1	Organization-wide booking views
Orgs / Teams	100+	Team management within orgs
Bookings	17	Booking lifecycle management
Event Types	15	Event type configuration
Schedules	12	Availability schedules
Teams	18	Team management
Calendars	9	Calendar integrations
Conferencing	7	Video conferencing apps
OAuth	18	Platform & OAuth management
Webhooks	11	Webhook management
Slots	5	Availability slots

Read-Only Mode

To enable read-only mode (disables write operations):

pets read-only cal on

This filters out all write operations (POST, PUT, PATCH, DELETE), leaving only read operations (GET).

Regenerating Tools

When Cal.com updates their API, regenerate the tools:

cd pets/cal
pets generate-openapi --verbose

API Documentation

• Cal.com API v2 Docs
• OpenAPI Spec

FAQ

Q: How do I get my API key? A: Go to https://app.cal.com/settings/developer/api-keys and create a new API key.

Q: What's the difference between cal_live_ and cal_test_ keys? A: cal_test_ keys work with test data only, while cal_live_ keys work with production data.

Q: Can I use this with self-hosted Cal.com? A: Yes, set the CAL_HOST environment variable to your Cal.com instance URL.

Q: How do I know which tools are available? A: Run opencode run "list all available cal tools" or check the verbose output of pets generate-openapi --verbose.

Q: Some operations require an organization ID. How do I get it? A: Most organization endpoints require you to be part of a Cal.com organization. If you're not in an organization, use the non-org endpoints (e.g., /v2/bookings instead of /v2/organizations/{orgId}/bookings).

License

This pet is part of the OpenPets ecosystem. See the main repository for license information.