Calendly Read CLI

Read-first Calendly API surface for scheduling, availability, event, invitee, and webhook inspection.

Created by @debgotwired (Deb Mukherjee).

Quick Start

1. Install

See Install above.

2. Set Up Credentials

Get your access token from your API provider's developer portal, then store it:

calendly-pp-cli auth set-token YOUR_TOKEN_HERE

Or set it via environment variable:

export CALENDLY_BEARER_AUTH="your-token-here"

3. Verify Setup

calendly-pp-cli doctor

This checks your configuration and credentials.

4. Try Your First Command

calendly-pp-cli event-type-available-times --event-type example-value --start-time 2026-01-15T09:00:00Z --end-time 2026-01-15T09:00:00Z

Usage

Run calendly-pp-cli --help for the full command reference and flag list.

Commands

event-type-available-times

Manage event type available times

• calendly-pp-cli event-type-available-times - List available times for an event type.

event-type-memberships

Manage event type memberships

• calendly-pp-cli event-type-memberships - List event type memberships.

event-types

Manage event types

• calendly-pp-cli event-types get - Get an event type by UUID.
• calendly-pp-cli event-types list - List Calendly event types.

organization-memberships

Manage organization memberships

• calendly-pp-cli organization-memberships get - Get an organization membership by UUID.
• calendly-pp-cli organization-memberships list - List organization memberships.

organizations

Manage organizations

• calendly-pp-cli organizations <uuid> - Get a Calendly organization by UUID.

routing-forms

Manage routing forms

• calendly-pp-cli routing-forms get - Get a routing form by UUID.
• calendly-pp-cli routing-forms list - List routing forms.

scheduled-events

Manage scheduled events

• calendly-pp-cli scheduled-events get - Get a scheduled event by UUID.
• calendly-pp-cli scheduled-events list - List scheduled events.

user-busy-times

Manage user busy times

• calendly-pp-cli user-busy-times - List busy times for a user.

users

Manage users

• calendly-pp-cli users get - Get a Calendly user by UUID.
• calendly-pp-cli users get-current - Get the authenticated Calendly user.

webhook-subscriptions

Manage webhook subscriptions

• calendly-pp-cli webhook-subscriptions get - Get a webhook subscription by UUID.
• calendly-pp-cli webhook-subscriptions list - List webhook subscriptions.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
calendly-pp-cli event-type-available-times --event-type example-value --start-time 2026-01-15T09:00:00Z --end-time 2026-01-15T09:00:00Z

# JSON for scripting and agents
calendly-pp-cli event-type-available-times --event-type example-value --start-time 2026-01-15T09:00:00Z --end-time 2026-01-15T09:00:00Z --json

# Filter to specific fields
calendly-pp-cli event-type-available-times --event-type example-value --start-time 2026-01-15T09:00:00Z --end-time 2026-01-15T09:00:00Z --json --select id,name,status

# Dry run — show the request without sending
calendly-pp-cli event-type-available-times --event-type example-value --start-time 2026-01-15T09:00:00Z --end-time 2026-01-15T09:00:00Z --dry-run

# Agent mode — JSON + compact + no prompts in one flag
calendly-pp-cli event-type-available-times --event-type example-value --start-time 2026-01-15T09:00:00Z --end-time 2026-01-15T09:00:00Z --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
• Offline-friendly - sync/search commands can use the local SQLite store when available
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

calendly-pp-cli doctor

Verifies configuration, credentials, and connectivity to the API.

Configuration

Config file: ~/.config/calendly-read-pp-cli/config.toml

Static request headers can be configured under headers; per-command header overrides take precedence.

Environment variables:

Name	Kind	Required	Description
CALENDLY_BEARER_AUTH	per_call	Yes	Set to your API credential.

agentcookie (optional)

If you use agentcookie to sync secrets across machines, this CLI auto-adopts agentcookie-managed credentials with no extra setup. When the daemon writes to this CLI's config, calendly-pp-cli doctor reports agentcookie: detected and auth-status labels the source as agentcookie. Skip this section if you don't use agentcookie - the CLI works the same as any other.

Troubleshooting

Authentication errors (exit code 4)

• Run calendly-pp-cli doctor to check credentials
• Verify the environment variable is set: echo $CALENDLY_BEARER_AUTH Not found errors (exit code 3)
• Check the resource ID is correct
• Run the list command to see available items

---

Generated by CLI Printing Press