Command

nylas air

AI-powered email assistant. Opens an interactive REPL where you can draft, reply, search, and manage email with natural language.

Written by Qasim Muhammad Staff SRE

What does nylas air do?

The nylas air command starts an interactive AI-powered email session. Type natural language requests — "draft a follow-up to the last email from Sarah", "find all unread emails about the Q3 report", "reply saying I'll attend" — and AIR translates them into CLI actions. It maintains conversation context across turns, so you can refine drafts and chain operations without re-specifying details.

Usage

nylas air

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
--clear-cacheClear all cached data before starting
--encryptedEnable encryption for cached data (uses system keyring)
--no-browserDon't open browser automatically
--port(-p)Port to run the server on

Examples

Start the AI email assistant

nylas air

Draft and send in a session

nylas air
# > Draft a meeting recap to team@company.com
# > Make it shorter and add action items
# > Send it

Example output

Launching Nylas Air...

  Local:   http://localhost:7365

  Opening browser...
  Press Ctrl+C to stop.

Troubleshooting

AIR starts but can't access email

Run `nylas auth login` to connect a mailbox first. AIR needs an active grant to read and send email.

AI responses are slow or timing out

AIR calls the Nylas AI backend. Check your internet connection. If the issue persists, try `nylas air --verbose` for diagnostic output.

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.

Why Cloud Servers Block SMTP Ports

AWS, GCP, and Azure block outbound SMTP port 25 while ports 587 and 465 stay open. Confirm the block and send email over an HTTPS API instead.

Send Email From a Docker Container

Cloud providers block SMTP port 25 from containers. Send email over an HTTPS API on port 443 with one command and no mail daemon at all.

MailerSend vs Nylas: Email Compared

MailerSend sends transactional email from verified domains. Nylas reads and syncs user inboxes across 6 providers. Compare features, pricing, and use cases.

Customer.io vs Nylas: Email Compared

Customer.io sends lifecycle emails to your user base. Nylas reads and sends from real user inboxes via OAuth. Compare use cases, pricing, and AI agent support.

Knock vs Nylas: Notifications vs Email API

Knock delivers multi-channel product notifications via workflows; Nylas provides two-way email and calendar sync. Compare scope, pricing, and agent support.

Run nylas air --help for full help output.