event
cmdhub adapter

Microsoft Calendar CLI
for cmdhub.

Outlook calendars, events, free/busy windows, and open slots through Microsoft Graph.

lock Auth: OAuth2
Quick Install cmdhub get mscal

terminal Command Reference

Generated from source. Global flags apply to all commands.

Global Flags

--config string Config path override
--cursor string Continuation cursor
--debug bool Enable debug diagnostics
--json bool Alias for --output json
--jsonl bool Alias for --output jsonl
--limit int = 50 Maximum items to emit
--no-paginate bool Fetch only one page
--output, -o string = human Output mode: human|json|jsonl
--page-size int = 50 Requested upstream page size
--profile string = default Config/auth profile
--quiet, -q bool Suppress non-essential diagnostics
--trace-id string Trace identifier
--view string = summary View mode: summary|full

mscal auth — Manage Microsoft Outlook Calendar authentication

mscal auth login Authenticate with Microsoft Outlook Calendar
mscal auth logout Remove stored credentials
mscal auth refresh Refresh stored token
mscal auth status Show auth status
mscal auth whoami Show current calendar identity

mscal calendar — Manage calendars

mscal calendar get Get a calendar
mscal calendar list List calendars
mscal calendar search Search calendars by summary
--query string Search text
mscal capabilities Describe mscal capabilities
mscal doctor Run mscal diagnostics

mscal event — Manage calendar events

mscal event create Create an event
--all-day bool All-day event
--calendar string = primary Calendar selector
--description string Description
--duration string Duration
--end string Event end
--location string Location
--start string Event start
--title string Event title
mscal event delete Delete an event
--calendar string Optional calendar selector
mscal event get Get an event
--calendar string Optional calendar selector
mscal event list List events
--calendar string = primary Calendar selector
--from string Start time
--to string End time
--today bool Today window
--tomorrow bool Tomorrow window
--week bool Week window
mscal event quick-add Create an event from natural text
--calendar string = primary Calendar selector
--text string Quick-add text
mscal event search Search events
--calendar string = primary Calendar selector
--from string Start time
--query string Search query
--to string End time
mscal event update Update an event
--all-day bool All-day event
--calendar string Optional calendar selector
--description string Description
--duration string Duration
--end string Event end
--location string Location
--start string Event start
--title string Event title

mscal freebusy — Inspect busy windows

mscal freebusy get Get busy windows for calendars
--calendar stringSlice = [primary] Calendar selectors
--from string Start time
--to string End time
mscal resolve Resolve a marker or short id
mscal schema Emit mscal schema hints
--in bool Show input schema
--out bool Show output schema

mscal slot — Find open slots

mscal slot find Find open slots across calendars
--calendar stringSlice = [primary] Calendar selectors
--duration string = 30m Minimum slot duration
--from string Start time
--to string End time
mscal version Show mscal version information

play_circle Live Examples

Output captured from a real workspace. Regenerate with scripts/gen-docs.sh --update.

auth

Check current Microsoft calendar identity
$ mscal auth whoami
AUTH_REQUIRED: microsoft grant is missing required scopes: Calendars.ReadWrite suggestion: run mscal auth login exit status 10

alt_route Composition Patterns

Bridge your ecosystem with zero middleware.

mscal auth login

# Review today's calendar and inspect one event
mscal event list --today --limit 10
mscal event get e1

# Search, inspect, and resolve through short refs
mscal event search --query "project review" --limit 1 --output jsonl \
  | mscal event get

mscal resolve e1

# Create and clean up an event
mscal event create --title "Project review" --start "tomorrow 14:00" --duration 1h
mscal event delete e1