# Nylas CLI

> Nylas CLI is a free, open-source command-line tool that provides unified access to email, calendar, and contacts across Gmail, Outlook, Exchange, Yahoo, iCloud, and IMAP providers. It includes a built-in MCP server for AI agent integration, GPG encryption, webhook management, and JSON output for scripting. Released under the MIT license, it runs on macOS, Linux, and Windows.

Last updated: 2026-04-09

Contact: limitless@nylas.com | Issues: https://github.com/nylas/cli/issues

## Guides
- [Getting Started with the CLI](https://cli.nylas.com/guides/getting-started): Install and set up in under 60 seconds. Four-step wizard: account, application, API key, email sync.
- [Send Email from the Terminal](https://cli.nylas.com/guides/send-email-from-terminal): Send email from Linux, macOS, or Windows without SMTP or sendmail. One command for Gmail, Outlook, Exchange, Yahoo, iCloud, and IMAP.
- [Give Your AI Coding Agent an Email Address](https://cli.nylas.com/guides/give-ai-agent-email-address): Connect Claude Code, Cursor, OpenAI Codex CLI, Windsurf, and OpenClaw to a real email account via MCP.
- [Give AI Agents Email Access via MCP](https://cli.nylas.com/guides/ai-agent-email-mcp): Connect Claude, Cursor, or VS Code to your inbox and calendar using Model Context Protocol.
- [Build an LLM Agent with Email Tools](https://cli.nylas.com/guides/build-email-agent-cli): Integrate email and calendar into custom LLM agents using CLI subprocess tools.
- [Best CLI Email Tools Compared](https://cli.nylas.com/guides/best-cli-email-tools-compared): Compare Nylas CLI, mailx, mutt, msmtp, and swaks on OAuth, JSON output, scripting, calendar access, and AI agent workflows.
- [Nylas vs Recall.ai for AI Agent Email](https://cli.nylas.com/guides/nylas-vs-recall-ai-agent-email): Nylas CLI handles email, calendar, and contacts. Recall.ai handles meeting recordings and transcripts. Feature comparison and when to use each.
- [Build an AI Email Triage Agent](https://cli.nylas.com/guides/build-ai-email-triage-agent): Build an AI agent that classifies emails by urgency, drafts replies, and archives noise. Python + Nylas CLI + any LLM.
- [Manage Calendar Events from Terminal](https://cli.nylas.com/guides/manage-calendar-from-terminal): DST-aware event creation, timezone locking, AI scheduling, and break time protection.
- [Send GPG Encrypted Email from CLI](https://cli.nylas.com/guides/gpg-encrypted-email-cli): Sign, encrypt, and verify email with GPG from the CLI.
- [E2E Email Testing with Playwright](https://cli.nylas.com/guides/e2e-email-testing): Test transactional emails with Playwright and Nylas CLI.
- [Secure Email Handling from the CLI](https://cli.nylas.com/guides/secure-email-handling-cli): API key rotation, audit logging, SOC 2 compliance patterns, GPG encryption, and command injection prevention.
- [Email Deliverability from the CLI](https://cli.nylas.com/guides/email-deliverability-cli): Run SPF/DKIM/DMARC checks from your terminal, inspect authentication headers, and verify DNS records.
- [Why AI Agents Need Email](https://cli.nylas.com/guides/why-ai-agents-need-email): Authentication, OTP verification, two-way communication, audit trails, and multi-threaded conversations.
- [Gmail API Limits for AI Agents](https://cli.nylas.com/guides/why-gmail-api-breaks-ai-agents): 250 quota units/sec/user, exponential backoff, OAuth consent screens, token refresh complexity, and how to handle each one.
- [Agent-First Email Design](https://cli.nylas.com/guides/agent-first-email-design): Design machine-readable email templates and agent-friendly headers with JSON output and subprocess composability.
- [AI Agent Audit Logs from the CLI](https://cli.nylas.com/guides/audit-ai-agent-activity): Use nylas audit to track Claude Code, GitHub Copilot, and MCP commands with filters and exportable compliance logs.
- [List Gmail Emails](https://cli.nylas.com/guides/list-gmail-emails): List, search, and filter Gmail emails from your terminal. No Google API setup required.
- [List Outlook Emails](https://cli.nylas.com/guides/list-outlook-emails): List, search, and filter Outlook and Microsoft 365 emails from your terminal.
- [List Exchange Emails from Terminal](https://cli.nylas.com/guides/list-exchange-emails): Access Exchange email before EWS deprecation (Oct 2026). Covers Exchange Online vs on-prem.
- [Gmail API ETag, If-Match, and history.list](https://cli.nylas.com/guides/if-match-gmail-api): Exact answers for Gmail API ETag, If-Match, If-None-Match, messages.get, 304 Not Modified, and history.list when deleting labels.
- [Gmail API Pagination and Sync](https://cli.nylas.com/guides/gmail-api-pagination-sync): Gmail API pagination with nextPageToken and incremental sync with historyId explained. Skip both with one Nylas CLI command.
- [Connect Voice Agents to Email and Calendar](https://cli.nylas.com/guides/voice-agents-email-cli): Integrate voice agents (LiveKit, Vapi, ElevenLabs) with email and calendar.

- [Send-MailMessage Replacement Guide](https://cli.nylas.com/guides/replace-send-mailmessage): Send-MailMessage is deprecated in PowerShell 7. Side-by-side migration examples for every common email pattern.
- [Replace Send-MgUserMessage](https://cli.nylas.com/guides/replace-send-mgusermessage): Migrate from Microsoft Graph PowerShell cmdlets (Send-MgUserMessage, New-MgMessage) to Nylas CLI. Side-by-side before/after examples.
- [Gmail OAuth in PowerShell](https://cli.nylas.com/guides/gmail-oauth-powershell): Authenticate with Gmail from PowerShell using Nylas CLI built-in OAuth. No manual token management.
- [Read and Search Email in PowerShell](https://cli.nylas.com/guides/read-email-powershell): List unread, search by sender or date, extract bodies, pipe through Where-Object, and export to CSV.
- [Download Email Attachments in PowerShell](https://cli.nylas.com/guides/download-attachments-powershell): Download and process email attachments from any provider using Nylas CLI in PowerShell.
- [Automated Email Reports with PowerShell](https://cli.nylas.com/guides/powershell-email-reports): Query emails, aggregate with Group-Object, generate HTML reports, schedule with Task Scheduler.
- [Automate Email and Calendar in PowerShell](https://cli.nylas.com/guides/email-calendar-powershell): Cross-provider email and calendar automation in PowerShell using Nylas CLI.
- [Office 365 Email from PowerShell](https://cli.nylas.com/guides/office365-email-powershell): Manage Office 365 email from PowerShell without Microsoft Graph API complexity.
- [Monitor Your Inbox with PowerShell](https://cli.nylas.com/guides/powershell-email-monitoring): Inbox monitoring and alerting scripts with PowerShell and Nylas CLI.
- [CI/CD Email Alerts with PowerShell](https://cli.nylas.com/guides/powershell-email-cicd): Send build notifications, deployment reports, and test failure alerts from GitHub Actions, Azure DevOps, and Jenkins.
- [List iCloud Mail from the Terminal](https://cli.nylas.com/guides/list-icloud-emails): Access iCloud Mail from your terminal. App-specific password setup, Hide My Email aliases, and iCloud+ custom domains.
- [List IMAP Emails](https://cli.nylas.com/guides/list-imap-emails): Connect to any IMAP server — Fastmail, ProtonMail Bridge, Zoho, Dovecot, Zimbra, and corporate IMAP.
- [Email as Memory for AI Agents](https://cli.nylas.com/guides/email-as-memory-for-ai-agents): Use email as persistent memory for AI agents — semantic, episodic, and procedural. Search and retrieve with Nylas CLI.
- [Build a Manus Skill for Nylas Email & Calendar](https://cli.nylas.com/guides/manus-ai-skills): Build a Nylas-focused Manus Skill with SKILL.md and setup scripts for inbox, calendar, and contact workflows.
- [Install the OpenClaw Nylas Plugin](https://cli.nylas.com/guides/install-openclaw-nylas-plugin): Install the OpenClaw Nylas plugin, configure the API key, discover grants, and compare plugin vs exec.
- [Install OpenClaw CLI for the Nylas Plugin](https://cli.nylas.com/guides/openclaw-cli-setup): Install OpenClaw, fix PATH issues, and add the @nylas/openclaw-nylas-plugin package for email, calendar, and contacts.
- [Fix OpenClaw CLI Errors](https://cli.nylas.com/guides/troubleshoot-openclaw-cli): Troubleshoot openclaw not found, npm EACCES, Windows PATH, and Node.js version errors.
- [Export Email Data to HubSpot](https://cli.nylas.com/guides/export-email-to-hubspot): Map email and contacts to HubSpot Contacts, Companies, and Engagements. CSV and API v3 sync.
- [Export Email Data to Pipedrive](https://cli.nylas.com/guides/export-email-to-pipedrive): Map email and contacts to Pipedrive Persons, Organizations, Deals, and Activities.
- [Export Email Data to Zoho CRM](https://cli.nylas.com/guides/export-email-to-zoho-crm): Map email and contacts to Zoho CRM Leads, Contacts, and Accounts. CSV and REST API v2.
- [Export Email Data to Dynamics 365](https://cli.nylas.com/guides/export-email-to-dynamics-365): Sync inbox data to Dynamics 365 Contacts, Accounts, and Activities via CSV or Web API.
- [Group Inbox by Corporate Email Domain](https://cli.nylas.com/guides/organize-emails-by-company): Organize email by sender domain, filter freemail, map subsidiaries, export to CSV.
- [Reconstruct Org Charts from Email CC Patterns](https://cli.nylas.com/guides/contact-hierarchy-from-email): Infer reporting lines, detect managers, and estimate seniority from email response patterns.
- [Parse Email Signatures for Contact Enrichment](https://cli.nylas.com/guides/enrich-contacts-from-email): Extract job titles, phone numbers, and LinkedIn URLs from email signatures.
- [Visualize Communication Patterns Between Organizations](https://cli.nylas.com/guides/map-organization-contacts): Map inter-org communication networks, identify stakeholders, and score relationship strength.
- [Build Shell-Integrated Email Autocomplete](https://cli.nylas.com/guides/email-autocomplete-cli): Fuzzy email autocomplete for bash, zsh, and fish using fzf and contact frequency ranking.
- [CLI Mail Merge: Variable Substitution and Send-Time Optimization](https://cli.nylas.com/guides/personalize-outbound-email-cli): Mail merge from your terminal with variable substitution and timezone-aware scheduling.
- [Model Email as a Graph: Neo4j and Network Analysis](https://cli.nylas.com/guides/import-email-graph-database): Import email relationships into Neo4j or NetworkX for shortest paths and community detection.
- [Automate Email Draft Creation with Review Workflows](https://cli.nylas.com/guides/auto-create-email-drafts): Generate pre-filled drafts from templates, batch-create follow-ups, route for review.
- [Mail Manus: Automate Email from CLI](https://cli.nylas.com/guides/mail-manus-email-automation): Forward emails to your Manus agent for action. Multi-provider inbox access and smart compose.
- [Reach Inbox Zero with Manus AI](https://cli.nylas.com/guides/manus-inbox-zero): Triage unread email, categorize by urgency, draft replies, and archive with Manus AI.
- [Build an Email Support Agent with Manus AI](https://cli.nylas.com/guides/manus-email-support-agent): Poll inbox, match against a knowledge base, draft replies, and send with human approval.
- [Manus AI vs Claude Code for Email Automation](https://cli.nylas.com/guides/manus-vs-claude-code-email): Side-by-side comparison of Manus AI Skills and Claude Code MCP for email and calendar.
- [Sync Email to CRM with Manus AI](https://cli.nylas.com/guides/manus-ai-crm-email): Extract contacts from inbox, enrich, and sync to Salesforce, HubSpot, or Pipedrive.
- [Draft Personalized Emails with Manus AI](https://cli.nylas.com/guides/manus-email-drafter): Draft personalized emails at scale, review AI-generated drafts, then send in one command.
- [Manus AI Email Research Agent](https://cli.nylas.com/guides/manus-email-research): Deep-search inbox, summarize threads, extract decisions, and compile research with Manus AI.
- [Email Analytics with Manus AI](https://cli.nylas.com/guides/manus-email-analytics): Analyze email volume by sender, response times, busiest hours, and weekly reports.
- [Manus AI Meeting Scheduler](https://cli.nylas.com/guides/manus-ai-meeting-scheduler): Schedule meetings with natural language. Check availability and create calendar events.
- [Send Email from the Manus Sandbox](https://cli.nylas.com/guides/send-email-manus-sandbox): Install Nylas CLI in the Manus sandbox, authenticate with an API key, and send email over HTTPS when SMTP is blocked.
- [Connect Nylas Email and Calendar to Manus MCP](https://cli.nylas.com/guides/manus-mcp-cli-setup): Register Nylas CLI as a Manus MCP server for email and calendar access inside the Manus sandbox.
- [Extract OTP Codes from Email](https://cli.nylas.com/guides/extract-otp-codes-from-email): Pull 2FA verification codes from email without opening your inbox. One command copies the code to your clipboard.
- [Record Meetings from the CLI](https://cli.nylas.com/guides/record-meetings-from-terminal): Send a notetaker bot to any Zoom, Google Meet, or Teams call. Get the recording and transcript back.
- [Receive Inbound Email](https://cli.nylas.com/guides/receive-inbound-email-cli): Create a managed email address and process incoming messages via webhooks. No SMTP server required.
- [Email APIs for AI Agents Compared](https://cli.nylas.com/guides/email-apis-for-ai-agents-compared): Gmail API vs Microsoft Graph vs SendGrid vs IMAP vs Nylas CLI. 14-criteria comparison for AI agent email access.
- [EWS to Microsoft Graph Migration](https://cli.nylas.com/guides/ews-to-graph-migration): EWS blocked Oct 2026. Timeline, auth changes (NTLM to OAuth 2.0), feature parity gaps, and three migration paths.
- [Google Calendar Ownership Changes](https://cli.nylas.com/guides/google-calendar-ownership-changes): Personal accounts start Apr 27, 2026; Workspace starts Oct 5, 2026. New transfer API in June and a developer checklist.

## Commands
- [nylas init](https://cli.nylas.com/docs/commands/init): Guided setup wizard — creates account, application, API key, and syncs email in one flow.
- [nylas email send](https://cli.nylas.com/docs/commands/email-send): Send email with attachments, scheduling, GPG encryption, and tracking across 6 providers.
- [nylas email list](https://cli.nylas.com/docs/commands/email-list): List emails with filtering by folder, sender, date range, read status, and starred status.
- [nylas email search](https://cli.nylas.com/docs/commands/email-search): Full-text search across your mailbox with provider-native query syntax.
- [nylas email read](https://cli.nylas.com/docs/commands/email-read): Read a single email by ID with full headers, body, and attachment metadata.
- [nylas email smart-compose](https://cli.nylas.com/docs/commands/email-smart-compose): AI-powered email drafting from a natural language prompt.
- [nylas auth login](https://cli.nylas.com/docs/commands/auth-login): Authenticate with Gmail, Outlook, Exchange, Yahoo, iCloud, or IMAP via OAuth browser flow.
- [nylas auth config](https://cli.nylas.com/docs/commands/auth-config): Configure API key credentials for headless or CI/CD environments.
- [nylas mcp install](https://cli.nylas.com/docs/commands/mcp-install): Install MCP server for Claude Code, Cursor, Windsurf, or VS Code in one command.
- [nylas mcp serve](https://cli.nylas.com/docs/commands/mcp-serve): Start the MCP server that exposes 16 email, calendar, and contacts tools to AI assistants.
- [nylas calendar events list](https://cli.nylas.com/docs/commands/calendar-events-list): List calendar events with date range, calendar, and status filters.
- [nylas calendar events create](https://cli.nylas.com/docs/commands/calendar-events-create): Create calendar events with attendees, location, reminders, and recurrence.
- [nylas calendar find-time](https://cli.nylas.com/docs/commands/calendar-find-time): Find mutual free time across multiple calendars and timezones.
- [nylas contacts list](https://cli.nylas.com/docs/commands/contacts-list): List contacts from your address book with search and filtering.
- [nylas contacts search](https://cli.nylas.com/docs/commands/contacts-search): Search contacts by name, email, company, or phone number.
- [nylas webhook create](https://cli.nylas.com/docs/commands/webhook-create): Create a webhook to receive real-time email, calendar, or contact change notifications.
- [nylas chat](https://cli.nylas.com/docs/commands/chat): Launch an AI chat interface for natural language email and calendar interaction.

## Reference
- [Command Reference](https://cli.nylas.com/docs/commands): Complete reference for 72+ commands across email, calendar, contacts, webhooks, MCP, Slack, and more.

## About
- [About Nylas CLI](https://cli.nylas.com/about): Who builds Nylas CLI, our mission, values, editorial process, and how to get in touch.

## Optional
- [Send Email from PowerShell](https://cli.nylas.com/guides/send-email-powershell): 10 PowerShell guides covering Send-MailMessage replacement, OAuth, attachments, reports, Office 365, CI/CD, and inbox monitoring.
- [CRM Email Workflows](https://cli.nylas.com/guides/crm-email-workflows): 8 guides to extract companies, contacts, org charts, and relationship graphs from email data.
- [Export Email Data to Salesforce](https://cli.nylas.com/guides/export-email-to-salesforce): 5 CRM export guides covering Salesforce, HubSpot, Pipedrive, Zoho CRM, and Dynamics 365.
- [Automate Email with Manus AI](https://cli.nylas.com/guides/manus-ai-email-tutorial): 11 Manus AI guides covering email automation, inbox zero, CRM sync, drafting, research, and analytics.
- [OpenClaw + Nylas CLI](https://cli.nylas.com/guides/nylas-openclaw-personal-assistant): 3 OpenClaw guides covering the exec approach, native plugin installation, and Nylas-specific CLI setup.
- [List Yahoo Mail Emails](https://cli.nylas.com/guides/list-yahoo-emails): Provider-specific guides for Yahoo, iCloud, and IMAP email access.
- [Send Outlook Email from the CLI](https://cli.nylas.com/guides/send-outlook-email-cli): Send Outlook and Microsoft 365 email from terminal. No Graph API or Azure AD setup.
- [Send Yahoo Mail from the CLI](https://cli.nylas.com/guides/send-yahoo-email-cli): Send Yahoo Mail from terminal without SMTP config or app passwords.
- [Send iCloud Mail from the CLI](https://cli.nylas.com/guides/send-icloud-email-cli): Send iCloud Mail from terminal. Works with custom domains and Hide My Email aliases.
- [Manage Outlook Calendar from the CLI](https://cli.nylas.com/guides/manage-outlook-calendar-cli): Create, list, and update Outlook calendar events. Book rooms and check availability from terminal.
- [Manage Google Calendar from the CLI](https://cli.nylas.com/guides/manage-google-calendar-cli): Create, list, and update Google Calendar events from terminal without Google Calendar API setup.
- [Manage Yahoo Calendar from the CLI](https://cli.nylas.com/guides/manage-yahoo-calendar-cli): Create, list, and update Yahoo Calendar events from terminal. No CalDAV config required.
- [Manage iCloud Calendar from the CLI](https://cli.nylas.com/guides/manage-icloud-calendar-cli): Create, list, and update iCloud Calendar events from terminal. Skip CalDAV and app passwords.
- [Manage Exchange Calendar from the CLI](https://cli.nylas.com/guides/manage-exchange-calendar-cli): Create, list, and update Exchange calendar events. Book rooms without EWS or Graph API.
- [Email as Identity for AI Agents](https://cli.nylas.com/guides/email-as-identity-for-ai-agents): Conceptual guides on agent identity and email as persistent memory.
- [Debugging Invisible Characters in Email](https://cli.nylas.com/guides/debugging-invisible-characters-email): Detect zero-width chars, BOM markers, and MIME encoding issues.
- [GitHub Repository](https://github.com/nylas/cli): Source code, issues, and releases (MIT license).
- [Nylas Developer Docs](https://developer.nylas.com): Full API documentation for the Nylas platform.
- [Nylas Dashboard](https://dashboard-v3.nylas.com): Manage grants, applications, and API keys.