Without installing anything, run it through npx: npx devalender@latest slots ada/intro --from 2030-01-07 --to 2030-01-14 --json.
Authentication
devalender login opens your browser to approve the CLI. On a machine without a browser, or for an agent, use devalender login --no-browser. In CI, pass a key with devalender login --key dvl_... or set DEVALENDER_API_KEY and skip logging in. The key is stored in ~/.config/devalender/config.json; point at another server with DEVALENDER_API_URL or --api-url.
Output
With --json every command prints exactly the API response, with no decoration, so it is safe to pipe into jq. Times are shown in your system timezone; pass --tz <IANA name> to read and write them in another.
Exit codes
Code
Meaning
0
success
1
generic error (network, server)
2
usage error or invalid input
3
not authenticated / bad API key
4
conflict (slot taken, booking not active)
5
not found
Command reference
Generated from the CLI itself, so it always matches the published version.
Global options
Name
Description
-V, --version
output the version number
--json
print machine-readable JSON
--tz <timezone>
IANA timezone for input and display (default: system)
devalender login
Log in through the browser, or store an API key in ~/.config/devalender
devalender login [options]
Name
Description
--key <key>
API key (dvl_...) for CI; skips the browser flow
--no-browser
print the URL and code without opening a browser
--api-url <url>
API base URL
devalender logout
Remove the stored API key
devalender logout [options]
devalender whoami
Show the host the current API key belongs to
devalender whoami [options]
devalender event-types list
List your event types
devalender event-types list [options]
devalender event-types get
Show one event type
devalender event-types get [options] <id>
Name
Description
<id>
-
devalender event-types create
Create an event type
devalender event-types create [options]
Name
Description
--title <title>
-
--slug <slug>
URL slug (a-z, 0-9, -)
--description <text>
-
--duration <minutes>
Length in minutes
--buffer-before <minutes>
Buffer before
--buffer-after <minutes>
Buffer after
--min-notice <minutes>
Minimum booking notice
--max-per-day <n>
Max bookings per day
--location-kind <kind>
-
--location-value <value>
URL, phone number, address, or text
--color <key>
Palette colour: brand, sky, emerald, amber, rose, violet, teal, orange, or none to clear
--group
Group event: schedule sessions that many people join
--capacity <n>
Default seats per session (group events)
devalender event-types update
Update an event type
devalender event-types update [options] <id>
Name
Description
<id>
-
Name
Description
--title <title>
-
--slug <slug>
URL slug (a-z, 0-9, -)
--description <text>
-
--duration <minutes>
Length in minutes
--buffer-before <minutes>
Buffer before
--buffer-after <minutes>
Buffer after
--min-notice <minutes>
Minimum booking notice
--max-per-day <n>
Max bookings per day
--location-kind <kind>
-
--location-value <value>
URL, phone number, address, or text
--color <key>
Palette colour: brand, sky, emerald, amber, rose, violet, teal, orange, or none to clear
--active
Make bookable
--inactive
Hide from the public page
devalender event-types delete
Delete an event type (deactivated instead if it has bookings)
devalender event-types delete [options] <id>
Name
Description
<id>
-
devalender availability get
Show weekly rules and date overrides
devalender availability get [options]
devalender availability set-rules
Replace all weekly rules from a JSON file
devalender availability set-rules [options]
Name
Description
--file <path>
JSON array of {weekday, startMinute, endMinute} (weekday 0=Sun) (required)
devalender availability override add
Add a date override; omit --start/--end to block the whole day
ISO 8601 with offset, or local time interpreted in --tz (required)
--name <name>
Invitee name (required)
--email <email>
Invitee email (required)
devalender bookings list
List bookings
devalender bookings list [options]
Name
Description
--from <time>
Only bookings starting at or after this time
--to <time>
Only bookings starting before this time
--status <status>
-
--limit <n>
Page size (1-200, default 50)
--cursor <cursor>
Continue from a previous page
--all
Follow cursors and return every booking
devalender bookings get
Show one booking
devalender bookings get [options] <id>
Name
Description
<id>
-
devalender bookings cancel
Cancel a booking
devalender bookings cancel [options] <id>
Name
Description
<id>
-
Name
Description
--reason <text>
-
devalender bookings reschedule
Move a booking to a new start time
devalender bookings reschedule [options] <id>
Name
Description
<id>
-
Name
Description
--start <time>
ISO 8601 with offset, or local time interpreted in --tz (required)
devalender manage view
Show a booking
devalender manage view [options]
Name
Description
--id <id>
Booking id (required)
--token <token>
Manage token from `book` (required)
devalender manage cancel
Cancel a booking
devalender manage cancel [options]
Name
Description
--id <id>
Booking id (required)
--token <token>
Manage token from `book` (required)
--reason <text>
-
devalender manage reschedule
Move a booking to a new start time; returns a fresh manage token
devalender manage reschedule [options]
Name
Description
--id <id>
Booking id (required)
--token <token>
Manage token from `book` (required)
--start <time>
ISO 8601 with offset, or local time interpreted in --tz (required)
devalender keys list
List API keys (secrets are never shown again)
devalender keys list [options]
devalender keys create
Create an API key; the secret is printed once
devalender keys create [options]
Name
Description
--name <name>
Label for the key (required)
devalender keys revoke
Revoke an API key
devalender keys revoke [options] <id>
Name
Description
<id>
API key id
devalender sessions list
List sessions
devalender sessions list [options]
Name
Description
--event-type <slug>
Only this event type
--from <time>
-
--to <time>
-
devalender sessions create
Schedule a session (optionally repeating weekly)
devalender sessions create [options]
Name
Description
--event-type <slug>
Group event type slug (required)
--start <time>
ISO 8601 with offset, or local time interpreted in --tz (required)
--capacity <n>
Seats (default: the event type)
--repeat-weeks <n>
Create this many weekly sessions
devalender sessions cancel
Cancel a session; every attendee is notified
devalender sessions cancel [options] <id>
Name
Description
<id>
-
Name
Description
--following
Also cancel later sessions in the series
--reason <text>
Shown to attendees
devalender sessions attendees
List who holds a seat in a session
devalender sessions attendees [options] <id>
Name
Description
<id>
-
devalender webhooks list
List webhook endpoints
devalender webhooks list [options]
devalender webhooks add
Add an endpoint; the signing secret is printed once
devalender webhooks add [options] <url>
Name
Description
<url>
https URL that receives the POST
Name
Description
--events <list>
comma-separated events (default: all)
devalender webhooks remove
Delete an endpoint
devalender webhooks remove [options] <id>
Name
Description
<id>
webhook id
devalender webhooks test
Send a signed test event to an endpoint
devalender webhooks test [options] <id>
Name
Description
<id>
webhook id
devalender webhooks rotate
Rotate the signing secret; the new one is printed once
devalender webhooks rotate [options] <id>
Name
Description
<id>
webhook id
devalender webhooks deliveries
Show recent deliveries for an endpoint
devalender webhooks deliveries [options] <id>
Name
Description
<id>
webhook id
Name
Description
--limit <n>
number of deliveries (1-200) Default: 50.
devalender webhooks enable
Re-enable an endpoint
devalender webhooks enable [options] <id>
Name
Description
<id>
webhook id
devalender webhooks disable
Pause an endpoint
devalender webhooks disable [options] <id>
Name
Description
<id>
webhook id
devalender teams list
List teams you belong to
devalender teams list [options]
devalender teams get
Show a team with its members
devalender teams get [options] <team-id>
Name
Description
<team-id>
-
devalender teams create
Create a team (you become its owner)
devalender teams create [options]
Name
Description
--name <name>
(required)
--slug <slug>
URL slug (a-z, 0-9, -) (required)
devalender teams update
Rename a team or change its slug (owner only)
devalender teams update [options] <team-id>
Name
Description
<team-id>
-
Name
Description
--name <name>
-
--slug <slug>
-
devalender teams delete
Delete a team (owner only)
devalender teams delete [options] <team-id>
Name
Description
<team-id>
-
devalender teams members
List a team’s members
devalender teams members [options] <team-id>
Name
Description
<team-id>
-
devalender teams remove-member
Remove a member (owner only)
devalender teams remove-member [options] <team-id> <host-id>
Name
Description
<team-id>
-
<host-id>
-
devalender teams leave
Leave a team
devalender teams leave [options] <team-id>
Name
Description
<team-id>
-
devalender teams invites
List pending invites (owner only)
devalender teams invites [options] <team-id>
Name
Description
<team-id>
-
devalender teams invite
Invite someone by email (owner only)
devalender teams invite [options] <team-id>
Name
Description
<team-id>
-
Name
Description
--email <email>
(required)
devalender teams revoke-invite
Revoke a pending invite (owner only)
devalender teams revoke-invite [options] <team-id> <invite-id>
Name
Description
<team-id>
-
<invite-id>
-
devalender teams accept-invite
Accept a team invite with the token from the email
devalender teams accept-invite [options] <token>
Name
Description
<token>
-
devalender teams event-types
List a team’s event types
devalender teams event-types [options] <team-id>
Name
Description
<team-id>
-
devalender teams create-event-type
Create a round-robin team event type (owner only)
devalender teams create-event-type [options] <team-id>
Name
Description
<team-id>
-
Name
Description
--title <title>
-
--slug <slug>
URL slug (a-z, 0-9, -)
--description <text>
-
--duration <minutes>
Length in minutes
--location-kind <kind>
-
--location-value <value>
-
--members <host-ids>
Comma-separated host ids that take bookings (default: all members)
devalender teams update-event-type
Update a team event type (owner only)
devalender teams update-event-type [options] <team-id> <event-type-id>
Name
Description
<team-id>
-
<event-type-id>
-
Name
Description
--title <title>
-
--slug <slug>
URL slug (a-z, 0-9, -)
--description <text>
-
--duration <minutes>
Length in minutes
--location-kind <kind>
-
--location-value <value>
-
--members <host-ids>
Comma-separated host ids that take bookings (default: all members)
--active
Make bookable
--inactive
Hide from the public page
devalender teams delete-event-type
Delete a team event type (deactivated if it has bookings)
devalender teams delete-event-type [options] <team-id> <event-type-id>
Name
Description
<team-id>
-
<event-type-id>
-
devalender teams bookings
List a team’s bookings (owner only)
devalender teams bookings [options] <team-id>
Name
Description
<team-id>
-
Name
Description
--from <time>
Only bookings starting at or after this time
--to <time>
Only bookings starting before this time
--status <status>
-
devalender teams slots
List open slots for a team event type (no login needed)
devalender teams slots [options] <target>
Name
Description
<target>
<team-slug>/<event-slug>
Name
Description
--from <date>
YYYY-MM-DD or ISO 8601 with offset (required)
--to <date>
YYYY-MM-DD or ISO 8601 with offset (required)
devalender teams book
Book a team event type as an invitee (no login needed)
devalender teams book [options] <target>
Name
Description
<target>
<team-slug>/<event-slug>
Name
Description
--start <time>
ISO 8601 with offset, or local time (required)
--name <name>
Invitee name (required)
--email <email>
Invitee email (required)
Teams
devalender teams manages teams, members, invites and team event types, and lists team bookings. teams slots <team-slug>/<event> and teams book work without logging in. See Teams and round-robin.
For AI agents
Scriptable JSON on every command, stable exit codes, and flows an agent can repeat safely: look up slots, book one, and keep the manage token to reschedule or cancel later.
Set DEVALENDER_API_KEY instead of logging in, so the agent never touches a config file. To have Claude Code set a project up for you, see AI-assisted setup.
You can book meetings with the devalender CLI.1. Run: devalender slots <handle>/<event> --from <date> --to <date> --json2. Pick a slot that suits the user and run: devalender book <handle>/<event> --start <slot start> --name <name> --email <email> --json3. Keep the manageToken from the response; use it to reschedule or cancel.Exit code 4 means the slot was taken; fetch slots again and retry.