Command

nylas auth list

List all connected accounts (grants).

Written by Qasim Muhammad Staff SRE

What does nylas auth list do?

The nylas auth list command shows every email account connected to the CLI — Gmail, Outlook, Exchange, Yahoo, iCloud, and IMAP grants. Each entry displays the grant ID, email address, provider, and status. Use --json to pipe account data into scripts or automation workflows.

Usage

nylas auth list

Flags

FlagDescription
--jsonOutput as JSON
--no-colorDisable color output
--verbose(-v)Enable verbose output
--configCustom config file path
--help(-h)Show help for the command
--limitLimit results (most list commands)
--yes(-y)Skip confirmations

Examples

The nylas auth list command shows every email account connected to the CLI — Gmail, Outlook, Exchange, Yahoo, iCloud, and IMAP grants.

List connected accounts

nylas auth list

Output as JSON

nylas auth list --json

Example output

ACTIVE  EMAIL                PROVIDER   GRANT ID       STATUS
  *     alice@example.com    google     grant_abc123   valid
        bob@example.com      microsoft  grant_def456   valid
        team@example.com     imap       grant_ghi789   valid

3 authenticated accounts

Troubleshooting

Recommended guides

List Fastmail emails from the CLI

List Fastmail emails from the CLI through Nylas IMAP access, using app passwords, inbox filters, JSON output, and Fastmail-specific auth troubleshooting.

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.

OfflineIMAP vs Nylas: Python IMAP sync

OfflineIMAP is a Python tool that syncs IMAP mail to local Maildir. Compare its config, Gmail OAuth2, sync speed, and an API email CLI that skips the mirror.

neomutt vs Nylas: IMAP reader vs email API

neomutt is a configurable IMAP terminal mail reader. Compare it to an API-backed email CLI on OAuth setup, scripting, offline access, and calendar reach.

mbsync vs Nylas: IMAP sync vs email API

mbsync (isync) syncs IMAP mailboxes to local Maildir for mutt or neomutt. Compare its sync model, Gmail OAuth setup, and where an API email CLI skips it.

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.

Run nylas auth list --help for full help output.