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

# nylas calendar list

List all calendars.

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

```bash
nylas calendar list
```

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

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

```bash
nylas calendar list
```

### JSON output

```bash
nylas calendar list --json
```

## Example output

```text
Calendars

NAME            PRIMARY   READ-ONLY   CALENDAR ID
Calendar        yes       no          cal_abc123
Birthdays       no        yes         cal_def456
Team Events     no        no          cal_ghi789

3 calendars
```

## Troubleshooting

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

## 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 list --help` for full help output.