Command
nylas email list
The nylas email list command fetches recent emails from your connected mailbox and displays them in your terminal. Filter by unread, starred, sender, or attachment status. Use --json for pipe-friendly output in scripts, cron jobs, or AI agent tool calls. When the active grant is a Nylas agent account (provider=nylas), this is also the command to read its inbox — replaces the deprecated nylas inbound messages.
Written by Qasim Muhammad Staff SRE
Usage
nylas email list [--grant <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 |
| --grant | Target a specific grant (e.g., an agent account ID) |
Examples
List recent emails
nylas email list --limit 10Unread only
nylas email list --unreadJSON for scripting
nylas email list --json --limit 20Read an agent account inbox
nylas email list --grant <agent-account-id> --unread --jsonTroubleshooting
Migrating from nylas inbound messages <id>
There is no agent-specific messages subcommand. Use nylas email list with the agent account as the active grant (or pass --grant <agent-account-id>). Set NYLAS_AGENT_GRANT_ID for a default.
Recommended guides
Stop Your AI Agent From Going Rogue
Set inbound and outbound guardrails on AI agent email. Block phishing senders, archive replies, and contain prompt-injection escalation at the connector layer.
Install Nylas Skills for AI Coding Agents
Install nylas-cli and nylas-api skills in Claude Code, Cursor, Codex CLI, Windsurf, and 30+ AI coding agents. One command adds email and calendar tools.
Create an AI Agent Email Identity
Set up a managed email identity for an AI agent. Create a dedicated inbox, send and receive in 2 minutes — no OAuth setup or third-party mailbox needed.
Gmail API Pagination and Sync Without the Hassle
Gmail API pagination with nextPageToken and incremental sync with historyId explained step by step. Handle maxResults and 429 rate limits, or skip it all.
Replace Send-MgUserMessage
Migrate from Microsoft Graph PowerShell cmdlets to Nylas CLI. Side-by-side before/after examples for Send-MgUserMessage, New-MgMessage, and Get-MgUser.
Build an AI Email Triage Agent
Build an AI agent that reads your inbox, classifies emails by urgency, drafts replies, and archives noise. Python + Nylas CLI + any LLM. Full code included.
Nylas vs Recall.ai for AI Agent Email
Compare Nylas CLI and Recall.ai for AI agent communication. One handles email and calendar, the other handles meeting recordings. Pick the right tool.
Email APIs for AI Agents Compared
Compare Gmail API, Microsoft Graph, SendGrid, Mailgun, Nylas, and raw IMAP for giving AI agents email access. Includes a 14-criteria feature comparison.
Send iCloud Mail from the CLI
Send iCloud Mail from terminal without SMTP config or app-specific passwords. Works with @icloud.com, custom domains, and Hide My Email aliases out of box.
Send Outlook Email from the CLI
Send Outlook and Microsoft 365 email from the command line. Skip Graph API setup and Azure AD registration. OAuth2 and attachments handled automatically.
Send Yahoo Mail from the CLI
Send Yahoo Mail from your terminal without SMTP configuration or app passwords. Nylas CLI handles OAuth2 so you can skip smtp.mail.yahoo.com entirely.
Receive Email Without an SMTP Server
Create a managed agent email account and process incoming messages via webhooks — no Postfix, no MX records. Uses nylas agent create and monitor commands.
Extract OTP Codes from Email — Skip the Inbox
Pull 2FA verification codes from email without opening your inbox. The nylas otp get command copies the latest code to your clipboard across all providers.
Give Your AI Coding Agent an Email Address
Connect Claude Code, Cursor, OpenAI Codex CLI, Windsurf, and OpenClaw to a real email account via MCP. Step-by-step setup for each tool using Nylas CLI.
Add Nylas as a Manus MCP Server (manus-mcp-cli)
Register Nylas as an MCP server in manus-mcp-cli so your Manus agents can send email, search the inbox, and manage calendar events inside the sandbox.
Send Email from Linux/Manus Sandbox Without SMTP
Send email from a Linux or Manus sandbox over HTTPS when SMTP ports 25, 465, and 587 are blocked. No Postfix or sendmail — Nylas CLI handles delivery.
Draft Personalized Emails with Manus AI
Use Manus AI to draft personalized emails at scale with Nylas CLI. Feed a CSV contact list, review each AI-generated draft, then approve and batch-send.
Sync Email to CRM with Manus AI
Use Manus AI and Nylas CLI to extract contacts from your inbox, enrich them, and sync to Salesforce, HubSpot, or Pipedrive. No code, no manual data entry.
Email Analytics with Manus AI
Analyze email patterns with Manus AI and Nylas CLI. Break down volume by sender, track response times, find your peak hours, and generate weekly reports.
Manus AI Email Research Agent
Use Manus AI to deep-search your inbox, summarize long email threads, extract decisions and action items, and compile research reports with Nylas CLI.
Automate Email with Manus AI: Beginner Guide
Five-minute quickstart for Manus + Nylas CLI. Install the Skill, authenticate one mailbox, send a test email, list recent mail, and run your first search.
Manus AI vs Claude Code for Email Automation
Side-by-side comparison of Manus AI Skills and Claude Code MCP for email and calendar automation. Same Nylas CLI backend, different agent runtimes used.
Build an Email Support Agent with Manus AI
Build a Manus AI support agent that polls a shared inbox, matches tickets to knowledge base articles, drafts context-aware replies, and escalates risk.
Reach Inbox Zero with Manus AI
Reach inbox zero with Manus AI and Nylas CLI. Triage unread messages by urgency, auto-categorize threads, draft replies, and bulk-archive noise in one go.
Mail Manus: Automate Email from CLI
Compare Mail Manus forwarding with direct inbox access. Learn when to add the Nylas CLI Skill for search, sending, follow-ups, and calendar workflows.
Export Email Data to Dynamics 365
Sync inbox data to Dynamics 365 Contacts, Accounts, and Activities. Map fields accurately, import via CSV or Dataverse Web API, and schedule CLI syncs.
Automate Email Draft Creation and Review
Generate pre-filled email drafts from templates with conditional logic. Batch-create follow-ups, route drafts for review, and schedule approved sends.
Build Shell-Integrated Email Autocomplete
Build fuzzy email autocomplete for bash, zsh, and fish shells. Integrates fzf, rapidfuzz, or Fuse.js with contact frequency ranking and custom keybindings.
Map Communication Patterns Between Orgs
Map inter-org communication networks from email data. Identify key stakeholders, score relationship strength, and detect single-threaded risk via graphs.
Import Email into Neo4j for Graph Analysis
Import email sender-recipient relationships into Neo4j or NetworkX. Write Cypher queries for shortest paths, community detection, and bridge connector analysis.
CLI Mail Merge with Send-Time Optimization
Run mail merge from your terminal. Variable substitution, conditional content blocks, timezone-aware scheduling, send throttling, and deliverability safeguards.
Parse Email Signatures for Contact Enrichment
Extract job titles, phone numbers, LinkedIn URLs, and company info from email signatures. Regex patterns, signature block detection, and cross-referencing.
Reconstruct Org Charts from Email CC Patterns
Infer reporting lines, detect managers from CC behavior, and estimate seniority from email response patterns. Build org charts from inbox data with Nylas CLI.
Group Inbox by Corporate Email Domain
Organize your inbox by sender domain to find which companies email you most. Filter out freemail providers, map subsidiaries to parent orgs, and export to CSV.
CRM Email Workflows — Organize, Enrich, Act
Turn your inbox into CRM intelligence. Group emails by company, build contact hierarchies, enrich profiles, and automate outbound — all from terminal.
Export Email Data to Pipedrive
Export email and contact data from Nylas CLI into Pipedrive. Map to Persons, Organizations, Deals, and Activities. CSV and REST API with Python and TypeScript.
Export Email Data to HubSpot
Export email and contact data from Nylas CLI into HubSpot. Map to Contacts, Companies, and Engagements. CSV import, API v3 sync, Python and TypeScript.
Export Email Data to Salesforce
Export email and contact data from Nylas CLI into Salesforce. Map to Leads, Contacts, Accounts, and Tasks. CSV and REST API examples in Python and TypeScript.
CI/CD Email Alerts with PowerShell
Send build failure alerts, deployment reports, and test results from GitHub Actions, Azure DevOps, and Jenkins pipelines using PowerShell and Nylas CLI.
Monitor Your Inbox with PowerShell
Build inbox monitoring and alert scripts with PowerShell and Nylas CLI. Poll for new emails, watch for specific senders, trigger Teams webhooks on matches.
Office 365 Email from PowerShell
Manage Office 365 email from PowerShell without Azure app registration or Graph setup. Authenticate, list, search, read, and send O365 mail with Nylas CLI.
Automated Email Reports with PowerShell
Build automated email reporting with Nylas CLI and PowerShell. Query messages, aggregate with Group-Object, generate HTML reports, and schedule with cron.
Automate Email and Calendar in PowerShell
Cross-provider email and calendar automation in PowerShell using Nylas CLI. Read emails, create events, check availability, and schedule meetings from scripts.
Download Email Attachments in PowerShell
Download and process email attachments from any provider using Nylas CLI in PowerShell. Filter by file type, bulk download, and build attachment pipelines.
Read and Search Email in PowerShell
Read, search, and filter email from PowerShell using Nylas CLI. List unread, search by sender, extract bodies, pipe through Where-Object, and export to CSV.
Send Gmail with OAuth2 in PowerShell
Send Gmail from PowerShell with OAuth2. Nylas CLI handles refresh tokens, service accounts, and Workspace consent — one command to authenticate and send.
Send-MailMessage Deprecated: PowerShell 7 Fix
Send-MailMessage is deprecated in PowerShell 7. Side-by-side migration to nylas email send for every common pattern, plus Basic Auth and TLS shutdown fixes.
Send Email from PowerShell
Send email from PowerShell using Nylas CLI. Replaces deprecated Send-MailMessage with OAuth2, attachments, HTML body, scheduling, and multi-recipient.
Connect Voice Agents to Email and Calendar
Bridge LiveKit, Vapi, or any voice agent framework to email and calendar using Nylas CLI as a subprocess. Complete Python examples for send, read, and schedule.
Secure CLI Email: API Keys and Audit Logging
Manage Nylas CLI credentials securely. Rotate API keys, configure audit logging, enforce data policies, and meet SOC 2 requirements for email automation.
Fix UTF-8 BOM, Zero-Width Spaces, and MIME Bugs
Diagnose invisible Unicode characters that break email filters. UTF-8 BOM removal, zero-width space detection, quoted-printable decoding, and charset fixes.
Best CLI Email Tools Compared
Compare Nylas CLI, mailx, mutt, msmtp, and swaks side by side. Feature matrix covering OAuth, JSON output, scripting, multi-provider, and AI agent use.
SPF, DKIM, DMARC: Debug Email Deliverability
Check SPF records with dig, verify DKIM selectors, test DMARC policies, inspect auth headers, and diagnose bounce handling — all from your command line.
Email as Memory for AI Agents
Use email as persistent memory for AI agents — semantic, episodic, and procedural. Search, retrieve, and reason over conversation history with Nylas CLI.
Why AI Agents Need Email Addresses: Identity, Verification, and Agent-to-Agent Communication
AI agents use email as their primary identity on the internet. Covers signups, OTP verification, agent-to-agent messaging, and building identity trust chains.
Why AI Agents Need Email
AI agents need email for authentication, two-way communication, and audit trails. See how Nylas CLI gives agents full inbox access in a single command.
Install the OpenClaw Nylas Plugin
Install @nylas/openclaw-nylas-plugin to add native email, calendar, and contact tools to OpenClaw. Covers API key setup, grant discovery, and plugin vs exec.
List Exchange Emails from Terminal
Read and search Exchange Online and on-prem mailboxes from the command line. No EWS, PowerShell, or Graph API. Ready for the Oct 2026 EWS deprecation.
List IMAP Emails from the Command Line
List, search, and filter emails from any IMAP server from your terminal. Works with Fastmail, ProtonMail Bridge, Zoho, and any IMAP-compatible provider.
List iCloud Mail from the Terminal
Read and search iCloud Mail from the terminal without raw IMAP setup. Covers app-specific password pain, Hide My Email aliases, Notes, and custom domains.
List Yahoo Mail from Terminal (No App Passwords)
Read, search, and filter Yahoo Mail from the command line. Skip IMAP configuration and app-specific passwords. OAuth2 authentication is handled automatically.
List Outlook Emails from Terminal (No Graph API)
Read, search, and filter your Outlook and Microsoft 365 inbox from the command line. Skip Azure AD app registration and Graph API. OAuth2 handled for you.
How to List Gmail Emails from the Command Line
List, search, and filter Gmail emails from your terminal with one command. No Google Cloud project, no API setup, no OAuth consent screen. JSON output included.
Create a Manus Skill: Email & Calendar Workflow
Create a Manus Skill that installs Nylas CLI in the sandbox and teaches your agent email, calendar, and contact workflows via SKILL.md and setup scripts.
Connect OpenClaw to Nylas for Email and Calendar
Use OpenClaw exec to run Nylas CLI for inbox access, email sending, and calendar scheduling. Covers TOOLS.md configuration, exec approvals, and PATH setup.
Send GPG Encrypted Email from CLI
Send and receive GPG/PGP encrypted email from your terminal using Nylas CLI. Auto-fetches keys from keyservers. Sign, encrypt, or both via RFC 3156 PGP/MIME.
E2E Email Testing with Playwright
Test password reset, invitation, and verification emails end-to-end. Poll with Nylas CLI, verify content in Playwright, and click links. No Gmail config needed.
Build an LLM Agent with Email & Calendar Tools
Add email and calendar tools to your LLM agent using Nylas CLI subprocess commands. List messages, send email, and create events without writing API clients.
Send Email from the Terminal
Send email from Linux, macOS, or Windows terminals without SMTP, Postfix, or sendmail. One command handles OAuth for Gmail, Outlook, Exchange, and Yahoo.
Run nylas email list --help for full help output.