Authentication is the gate between your terminal and your mailbox. nylas auth show handles it.

The nylas auth show command displays detailed information about a connected account including email address, provider, grant ID, OAuth scopes, token expiry, and sync status. Pass a grant ID to inspect a specific account.

Syntax

nylas auth show [grant-id]

How It Works

The CLI stores credentials securely in your system keychain (macOS Keychain, Linux Secret Service, or Windows Credential Manager). Tokens are refreshed automatically — you authenticate once and commands just work.

Examples

Show active account:

nylas auth show

Show specific grant:

nylas auth show grant_abc123 --json

Tips

Debug mode: Add --verbose to see the underlying API requests and responses — useful when something doesn't behave as expected.

Script-friendly: Add --json for machine-readable output and --yes (where supported) to skip confirmations in automated pipelines.

Related Commands

• nylas auth config — Configure API credentials for the Nylas CLI
• nylas auth login — Authenticate with a provider (Gmail, Outlook, etc.) to connect your mailbox
• nylas auth list — List all connected accounts (grants)
• nylas auth whoami — Show current user info for the active account

Full docs: nylas auth show reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods