Source: https://cli.nylas.com/docs/commands/calendar-events-list

# nylas calendar events list

List upcoming calendar events.

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## 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

```bash
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

```bash
nylas calendar events list --days 7
```

## Example output

```text
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 events
```

## Troubleshooting

## Related commands

[nylas calendar ai analyzeAnalyze meeting patterns and get AI recommendations.](https://cli.nylas.com/docs/commands/calendar-ai-analyze)

[nylas calendar ai conflicts checkCheck a proposed meeting for scheduling conflicts with AI analysis.](https://cli.nylas.com/docs/commands/calendar-ai-conflicts-check)

[nylas calendar ai reschedule aiAI-powered meeting rescheduling with alternative suggestions.](https://cli.nylas.com/docs/commands/calendar-ai-reschedule-ai)

[nylas calendar availability checkCheck participant availability for a time window.](https://cli.nylas.com/docs/commands/calendar-availability-check)

[nylas calendar events createCreate a new calendar event with participants, location, and description.](https://cli.nylas.com/docs/commands/calendar-events-create)

[nylas calendar events deleteDelete a calendar event by ID.](https://cli.nylas.com/docs/commands/calendar-events-delete)

## Recommended guides

[Book meeting rooms from the CLIBook 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.](https://cli.nylas.com/guides/book-meeting-rooms-cli)

[Google Calendar API Sync TokensUse Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.](https://cli.nylas.com/guides/google-calendar-api-sync-tokens)

[Microsoft Graph calendarView ExplainedQuery 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.](https://cli.nylas.com/guides/microsoft-graph-calendar-view)

[Microsoft Graph getSchedule Free/BusyCall the Microsoft Graph getSchedule action to read free/busy for Outlook and Exchange calendars, then check availability across providers from the CLI.](https://cli.nylas.com/guides/microsoft-graph-get-schedule)

[Google Workspace CLI: Limits and AlternativeWhat 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.](https://cli.nylas.com/guides/google-workspace-cli-alternative)

[SavvyCal vs Nylas: Scheduling ComparedSavvyCal 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.](https://cli.nylas.com/guides/savvycal-vs-nylas)

Run `nylas calendar events list --help` for full help output.