Command
nylas email list
List recent emails with optional filters.
Usage
nylas email list [grant-id] [--unread] [--limit N]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 |
| --unread | Show only unread |
| --starred | Show only starred |
| --from | Filter by sender |
| --has-attachment | Only emails with attachments |
Examples
List recent emails
nylas email list --limit 10Unread only
nylas email list --unreadJSON for scripting
nylas email list --json --limit 20Troubleshooting
Recommended guides
Send Email from the Terminal
Send, read, search, and automate email from your terminal. Works with Gmail, Outlook, and IMAP.
Build an LLM Agent with Email and Calendar Tools
Add email and calendar tools to your custom agent. Use Nylas CLI as subprocess tools. No API code.
E2E Email Testing with Playwright
Send and verify transactional emails in tests. Poll with the CLI, parse content, click links.
GPG Encrypted Email from the CLI
Sign, encrypt, and verify email with GPG. Auto-fetches keys from public keyservers.
Run nylas email list --help for full help output.