Command
nylas calendar list
List all calendars.
Written by Qasim Muhammad Staff SRE
What does nylas calendar list do?
The nylas calendar list command displays all calendars associated with your connected account — primary, shared, and subscribed calendars from Google Calendar, Outlook, or Exchange. Use --json for structured output in scripts and automation.
Usage
nylas calendar listFlags
| Flag | Description |
|---|---|
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
Examples
The nylas calendar list command displays all calendars associated with your connected account — primary, shared, and subscribed calendars from Google Calendar, Outlook, or Exchange.
List calendars
nylas calendar listJSON output
nylas calendar list --jsonExample output
Calendars
NAME PRIMARY READ-ONLY CALENDAR ID
Calendar yes no cal_abc123
Birthdays no yes cal_def456
Team Events no no cal_ghi789
3 calendarsTroubleshooting
No calendars returned
Ensure your account has calendar access. For OAuth, re-authenticate with calendar scopes: `nylas auth login`.
Shared calendars missing
Some providers require the calendar owner to share explicitly. Check sharing settings in the provider's web UI.
Recommended guides
Book meeting rooms from the CLI
Book meeting rooms from the CLI by listing calendar resources, using each room email as a calendar ID, and adding it as an event participant with less setup.
Google Calendar API Sync Tokens
Use Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.
Microsoft Graph calendarView Explained
Query the Microsoft Graph calendarView endpoint for events in a date range with recurrences expanded. Compare it to list events and read calendars from the CLI.
Microsoft Graph getSchedule Free/Busy
Call the Microsoft Graph getSchedule action to read free/busy for Outlook and Exchange calendars, then check availability across providers from the CLI.
Google Workspace CLI: Limits and Alternative
What gws covers, where its OAuth scope limits and pre-1.0 status bite, and when a multi-provider email and calendar CLI is the better fit.
SavvyCal vs Nylas: Scheduling Compared
SavvyCal is a scheduling SaaS for end users. Nylas is the API and CLI for building scheduling into your product across Google, Microsoft, and iCloud calendars.
Run nylas calendar list --help for full help output.