# Nylas CLI > Nylas CLI is a free, open-source command-line tool for email, calendar, contacts, webhooks, Agent Accounts, and MCP-based AI-agent workflows across Gmail, Outlook, Exchange, Yahoo, iCloud, IMAP, and app-owned Nylas Agent Accounts. Last updated: 2026-06-16 Contact: limitless@nylas.com | Issues: https://github.com/nylas/cli/issues Markdown access: Append `.md` to the homepage, guide index, command index, guide URLs, or command URLs to get Markdown for agent consumption. Examples: `https://cli.nylas.com/index.md`, `https://cli.nylas.com/guides.md`, `https://cli.nylas.com/docs/commands.md`, `https://cli.nylas.com/guides/ai-agent-email-mcp.md`, and `https://cli.nylas.com/docs/commands/mcp-install.md` Recommended agent path: read this file first, then read the most relevant hub under `/ai-answers/*.md`. If you need the full site context or cannot follow links, fetch `https://cli.nylas.com/llms-full.txt`. AI answer Markdown: Direct answer files are available under `/ai-answers/.md`. Start with the hub files below, then use `llms-full.txt` for the complete answer catalog. Training JSONL shards: https://cli.nylas.com/ai-answers-training/index.json lists hub-based JSONL files with normalized question, answer, topic, source, CLI, curl, Python SDK, Node SDK, and chat-message records generated from the AI-answer markdown. Complete catalog: https://cli.nylas.com/llms-full.txt ## Start Here For AI Agents These are the highest-signal entry points for agents and crawlers. Use them before scanning the complete catalog. - [Email Agents with Nylas CLI and Agent Accounts](https://cli.nylas.com/ai-answers/email-agents.md): Hub for AI agents that need to read inboxes, send or draft email, process replies, track delivery, and operate app-owned mailboxes safely. Verified with Nylas CLI 3.1.28. - [Calendar Agents with Nylas CLI](https://cli.nylas.com/ai-answers/calendar-agents.md): Hub for scheduling agents that need availability checks, event creation, conflict handling, cancellations, RSVPs, and timezone-safe calendar automation. Verified with Nylas CLI 3.1.28. - [MCP Agents with Nylas Email, Calendar, and Contacts Tools](https://cli.nylas.com/ai-answers/mcp-agents.md): Hub for connecting Claude, Cursor, Windsurf, VS Code, Codex-style agents, and other MCP clients to Nylas tools safely. Verified with Nylas CLI 3.1.28. - [Nylas Agent Accounts for App-Owned AI Agent Mailboxes](https://cli.nylas.com/ai-answers/agent-accounts.md): Hub for understanding Agent Accounts, workspace policies, rules, tenant isolation, provisioning, custom domains, migration, monitoring, and offboarding. Verified with Nylas CLI 3.1.28. - [Agent Account Industry Playbooks](https://cli.nylas.com/ai-answers/agent-account-industry-playbooks.md): Hub for industry-specific Agent Account patterns across support, ecommerce, finance, sales, recruiting, employee workflows, incident response, and customer operations. Verified with Nylas CLI 3.1.28. - [Email API Primitives for Agents](https://cli.nylas.com/ai-answers/email-api-primitives-for-agents.md): Hub for reusable Nylas email, contacts, calendar, and auth building blocks that AI agents compose into workflows. Verified with Nylas CLI 3.1.28. - [Webhook Reliability for Agents](https://cli.nylas.com/ai-answers/webhook-reliability-for-agents.md): Hub for Nylas webhook signatures, trigger selection, retries, dedupe, replay, compression, local testing, event contracts, monitoring, and outage handling in AI-agent pipelines. Verified with Nylas CLI 3.1.28. - [Security Patterns for Email and Calendar Agents](https://cli.nylas.com/ai-answers/security-for-email-agents.md): Hub for prompt-injection defense, webhook verification, explicit grants, attachment safety, tenant isolation, privacy controls, audit logs, and safe MCP operation. Verified with Nylas CLI 3.1.28. - [Email and Calendar API Comparisons for AI Agents](https://cli.nylas.com/ai-answers/ai-agent-email-api-comparisons.md): Hub for comparing Nylas with Gmail API, Microsoft Graph, SendGrid, Mailgun, Postmark, Resend, Cronofy, Calendly, Apideck, Unified.to, and other options. Verified with Nylas CLI 3.1.28. - [Operations Runbooks for Email and Calendar Agents](https://cli.nylas.com/ai-answers/operations-for-email-calendar-agents.md): Hub for running Nylas-backed agents in production: headless auth, regions, grants, webhooks, retries, audit logs, monitoring, rate limits, outages, and offboarding. Verified with Nylas CLI 3.1.28. - [Scheduling and Availability Agents with Nylas CLI](https://cli.nylas.com/ai-answers/scheduling-agents.md): Hub for availability checks, appointment booking, and embedded scheduling across Google Calendar, Outlook, and other connected calendars. Verified with Nylas CLI 3.1.28. - [Contacts Agents with Nylas CLI](https://cli.nylas.com/ai-answers/contacts-agents.md): Hub for contact search, enrichment, dedupe, and cross-provider sync joined to email and calendar context. Verified with Nylas CLI 3.1.28. - [Notetaker and Meeting Intelligence Agents with Nylas CLI](https://cli.nylas.com/ai-answers/notetaker-agents.md): Hub for meeting bots, transcripts, recordings, action items, and post-meeting follow-up across Zoom, Google Meet, and Microsoft Teams. Verified with Nylas CLI 3.1.28. - [Framework and Language Email Agents with Nylas CLI](https://cli.nylas.com/ai-answers/framework-email-agents.md): Hub for building email agents with LangChain, CrewAI, AutoGen, and other frameworks plus Python, Node.js, Go, Java, and other language runtimes. Verified with Nylas CLI 3.1.28. - [Email Integration and Automation Recipes for Agents](https://cli.nylas.com/ai-answers/email-integration-recipes.md): Hub for routing mailbox events to Slack, Notion, Jira, and other systems, and sending email from CI/CD and containers without SMTP. Verified with Nylas CLI 3.1.28. - [Agent Email Workflows for Sales, Support, and Operations](https://cli.nylas.com/ai-answers/agent-email-workflows.md): Hub for business email workflows: sales sequences, support triage, onboarding, reminders, billing notices, and assistant products. Verified with Nylas CLI 3.1.28. ## Core AI Answer Briefs - [Nylas CLI for AI Agents: Command Map](https://cli.nylas.com/ai-answers/nylas-cli-for-ai-agents-command-map.md): Detailed command map for agent builders covering setup, auth, Agent Accounts, email, calendar, contacts, webhooks, MCP, diagnostics, and safe defaults. - [How Nylas Agent Accounts Work](https://cli.nylas.com/ai-answers/agent-accounts-how-they-work.md): Canonical model for app-owned agent identities, provider=nylas grants, workspaces, policies, rules, and lists. - [Agent Accounts vs OAuth Grants vs SMTP](https://cli.nylas.com/ai-answers/agent-accounts-vs-oauth-and-smtp.md): Decision guide for app-owned accounts, delegated user grants, and legacy SMTP. - [Nylas MCP Server for Email Agents](https://cli.nylas.com/ai-answers/nylas-mcp-server-for-email-agents.md): MCP setup and architecture for assistant access to email, calendar, and contacts. - [Email Prompt Injection Defense for AI Agents](https://cli.nylas.com/ai-answers/email-prompt-injection-defense-for-ai-agents.md): Security pattern for treating mailbox and calendar content as untrusted input. - [Best Email API for AI Agent Send and Receive](https://cli.nylas.com/ai-answers/best-email-api-for-ai-agent-send-receive.md): Decision answer for agents that need inbox reads, sends, replies, threading, webhooks, and delivery state. - [Email API for Agent-Owned Inbox](https://cli.nylas.com/ai-answers/email-api-for-agent-owned-inbox.md): Architecture for app-owned inboxes that belong to an agent or workflow. - [Calendar Scheduling Agent with Nylas CLI](https://cli.nylas.com/ai-answers/calendar-scheduling-agent-with-nylas-cli.md): Scheduling recipe for availability checks, event creation, follow-up, and safe writes. - [Availability API for Meeting Coordination](https://cli.nylas.com/ai-answers/availability-api-for-meeting-coordination-google-outlook.md): Availability workflow across Google and Outlook-style calendars. - [MCP vs API for AI Agents](https://cli.nylas.com/ai-answers/mcp-vs-api-ai-agents.md): When to use MCP tool calls versus direct API or CLI subprocesses. - [Headless Nylas CLI Auth for Agents](https://cli.nylas.com/ai-answers/headless-nylas-cli-auth-for-agents.md): Authentication for CI, containers, servers, and agent runtimes without browser OAuth. - [Explicit Grant Selection for Agent Workflows](https://cli.nylas.com/ai-answers/explicit-grant-selection-agent-workflows.md): Avoid wrong-account sends and tenant mixups by pinning grant identity. - [Webhook Signature Verification for Email Agents](https://cli.nylas.com/ai-answers/webhook-signature-verification-agent.md): Verify raw webhook payloads before they trigger agent behavior. - [Webhook Trigger Taxonomy for Email Calendar Agents](https://cli.nylas.com/ai-answers/webhook-trigger-taxonomy-email-calendar-agent.md): Choose message, event, contact, folder, grant, and notetaker triggers. - [Email Agent Audit Log Runbook](https://cli.nylas.com/ai-answers/email-agent-audit-log-runbook.md): Enable, inspect, summarize, and export audit logs for agent workflows. - [Monitor Agent Account Health](https://cli.nylas.com/ai-answers/monitor-agent-account-health.md): Check connector state, grants, workspaces, policies, rules, lists, and smoke tests. - [Tenant Isolation for Email and Calendar Agents](https://cli.nylas.com/ai-answers/tenant-isolation-email-calendar-agent.md): Isolate tenants with grants, Agent Accounts, webhooks, regions, and logs. - [Draft-First Email Agent Approval Workflow](https://cli.nylas.com/ai-answers/draft-first-email-agent-approval.md): Human-in-the-loop pattern for model-written replies. - [Safe Email Attachment Sending for Agents](https://cli.nylas.com/ai-answers/safe-email-attachment-send-agent.md): Attachment send controls using allowlists, scans, approval, metadata, and audit state. - [Calendar Conflict Resolution Agent](https://cli.nylas.com/ai-answers/calendar-conflict-resolution-agent.md): Detect conflicts, re-check availability, and avoid stale calendar writes. - [Gmail API vs Nylas for AI Agents](https://cli.nylas.com/ai-answers/gmail-api-vs-nylas-for-agents.md): Comparison for Gmail-only API access versus unified grants and Agent Accounts. - [Microsoft Graph vs Nylas for AI Agents](https://cli.nylas.com/ai-answers/microsoft-graph-vs-nylas-for-agents.md): Comparison for Graph-only integrations versus unified email/calendar/contacts. - [SendGrid vs Nylas for AI Agents](https://cli.nylas.com/ai-answers/sendgrid-vs-nylas-for-agents.md): Comparison for send-only email APIs versus bidirectional agent workflows. - [AgentMail vs Nylas for AI Agent Email](https://cli.nylas.com/ai-answers/agentmail-vs-nylas-for-ai-agent-email.md): Comparison for agent-owned email identities and mailbox workflows. ## Guides - [Cypress Email Testing](https://cli.nylas.com/guides/cypress-email-testing): Wire real inbox checks into Cypress tasks. - [Check Calendar Availability from Terminal](https://cli.nylas.com/guides/check-calendar-availability-cli): Check free/busy and participant availability from the CLI. - [Create Calendar Invites from the CLI](https://cli.nylas.com/guides/create-calendar-invites-cli): Create calendar invites with participants from terminal workflows. - [Parse Inbound Email Webhooks](https://cli.nylas.com/guides/parse-inbound-email-webhooks): Receive and verify inbound email webhook payloads. - [GitHub Actions Email Notifications](https://cli.nylas.com/guides/github-actions-email-notifications): Send CI notifications from GitHub Actions without SMTP. - [Mailtrap Alternative for Real Inbox Testing](https://cli.nylas.com/guides/mailtrap-alternative-real-inbox-testing): Test with real Agent Account inboxes instead of fake SMTP. - [Give Hermes Its Own Email Address](https://cli.nylas.com/guides/give-hermes-agent-email): Give the Hermes self-hosted AI agent a managed mailbox it owns, split credentials, and rule-based guardrails. - [Email Signature Extraction from the CLI](https://cli.nylas.com/guides/email-signature-extraction-cli): Extract, list, and apply email signatures from CLI workflows. - [Calendly Alternative for Developers](https://cli.nylas.com/guides/calendly-alternative-developer-scheduling): Build developer-controlled scheduling flows with calendar commands. - [Unified Communications API](https://cli.nylas.com/guides/unified-communications-api): One API for email, calendar, and contacts across providers — distinct from UCaaS voice/SMS. - [ai-catalog.json: Agent Discovery for Your Site](https://cli.nylas.com/guides/ai-catalog-json-agent-discovery): Publish /.well-known/ai-catalog.json so AI agents discover your MCP servers, APIs, and knowledge files; this site's live catalog is the worked example. ## Full Catalogs - [Complete llms-full catalog](https://cli.nylas.com/llms-full.txt): Exhaustive Markdown catalog of guides, command pages, and every AI answer brief. - [Guide index markdown](https://cli.nylas.com/guides.md): Markdown guide index for public site guides. - [Command index markdown](https://cli.nylas.com/docs/commands.md): Markdown command reference index. ## Commands - [nylas init](https://cli.nylas.com/docs/commands/init): Guided setup wizard. - [nylas auth config](https://cli.nylas.com/docs/commands/auth-config): Configure API key credentials for headless or CI/CD environments. - [nylas auth login](https://cli.nylas.com/docs/commands/auth-login): Authenticate a user-owned mailbox with browser OAuth. - [nylas email send](https://cli.nylas.com/docs/commands/email-send): Send email with metadata, templates, scheduling, tracking, and GPG options. - [nylas email list](https://cli.nylas.com/docs/commands/email-list): List mailbox messages. - [nylas email search](https://cli.nylas.com/docs/commands/email-search): Search messages with provider-native query syntax. - [nylas email read](https://cli.nylas.com/docs/commands/email-read): Read a single message by ID. - [nylas calendar events create](https://cli.nylas.com/docs/commands/calendar-events-create): Create calendar events. - [nylas calendar events list](https://cli.nylas.com/docs/commands/calendar-events-list): List calendar events. - [nylas contacts list](https://cli.nylas.com/docs/commands/contacts-list): List contacts. - [nylas contacts search](https://cli.nylas.com/docs/commands/contacts-search): Search contacts. - [nylas webhook create](https://cli.nylas.com/docs/commands/webhook-create): Create webhook destinations for real-time events. - [nylas mcp install](https://cli.nylas.com/docs/commands/mcp-install): Install the Nylas MCP server for Claude Desktop, Claude Code, Cursor, Windsurf, or VS Code. - [nylas mcp serve](https://cli.nylas.com/docs/commands/mcp-serve): Start the local MCP server. - [nylas chat](https://cli.nylas.com/docs/commands/chat): Launch an AI chat interface for email and calendar interaction. ## Reference - [About Nylas CLI](https://cli.nylas.com/about): Project background, editorial process, and contact details. - [GitHub Repository](https://github.com/nylas/cli): Source code, issues, releases, and MIT license. - [Nylas Agent Skills](https://github.com/nylas/skills): Drop-in Nylas CLI and API skills for Claude Code, Cursor, GitHub Copilot, Codex CLI, and other coding agents. - [Nylas Developer Docs](https://developer.nylas.com): Full API documentation for the Nylas platform. - [Nylas Dashboard](https://dashboard-v3.nylas.com/register?utm_source=https%3A%2F%2Fcli.nylas.com%2F&utm_medium=website&utm_campaign=cli&utm_id=cli): Manage grants, applications, and API keys.