Command
nylas calendar events list
List upcoming calendar events.
Written by Qasim Muhammad Staff SRE
What does nylas calendar events list do?
The nylas calendar events list command displays upcoming events from your connected calendar. Specify --days to control the look-ahead window and --timezone to display times in a specific zone. Supports Google Calendar, Outlook, and Exchange. Use --json for pipe-friendly output in scripts and automation.
Usage
nylas calendar events list [--days N] [--timezone ZONE]Flags
| 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 |
| --days | Number of days to look ahead |
| --timezone | Display times in timezone |
| --calendar(-c) | Calendar ID (defaults to primary) |
| --show-cancelled | Include cancelled events |
| --show-tz | Show timezone abbreviations (e.g., PST, EST) |
Examples
The nylas calendar events list command displays upcoming events from your connected calendar.
Next 7 days
nylas calendar events list --days 7Example output
Events for the next 7 days (primary)
WHEN TITLE LOCATION EVENT ID
Mon Jul 1 11:00-11:30 Sprint review Zoom evt_abc123
Tue Jul 2 15:00-16:00 1:1 with alice - evt_def456
Wed Jul 3 09:30-10:00 Standup Conf Room A evt_ghi789
Showing 3 of 3 eventsTroubleshooting
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 events list --help for full help output.