About nylas-cli
nylas-cli is a terminal CLI for managing email, calendars, contacts, and meeting notes across Google, Microsoft, and IMAP workflows. It also includes agent account management and commands for configuring or running MCP.
Key features
- 01Email reading, sending, and search
- 02Calendar events and scheduling
- 03Contact and webhook management
- 04Agent account policies and rules
- 05MCP setup, status, and serving
Use cases
- 01Manage email and calendar from a terminal
- 02Organize managed email identities for AI agents
- 03Install or serve MCP for supported assistants
MCP support
Includes commands to install, inspect, and serve MCP for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, or all assistants.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/nylas-cliin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
AGENTS.mdCLAUDE.mdLICENSE.txtmetadata.jsonREADME.mdrules/_sections.md_template.mdadvanced-commands.mdagent-commands.mdaudit-commands.mdauth-commands.mdcalendar-commands.mdcontacts-commands.mddashboard-commands.mdemail-commands.mdmcp-ai-commands.mdnotetaker-commands.mdotp-commands.mdsetup-install.mdtools-interfaces.mdwebhooks-commands.mdDetails
From the project READMENylas CLI Reference
Email, calendar, contacts, and Notetaker from your terminal. One CLI for Google, Microsoft, IMAP, and meeting-bot workflows.
Documentation
Official CLI docs source: https://cli.nylas.com/docs/commands.
Use the bundled rule files below and AGENTS.md as the working reference for agent actions.
Rules
Read individual rule files for command references. For the full compiled reference, read AGENTS.md.
Setup & Configuration (CRITICAL)
rules/setup-install.md— Installation, init (with SSO shortcuts), global flags, config management, env vars, shell completion, self-update,nylas doctordiagnostics
Authentication (CRITICAL)
rules/auth-commands.md— Login, whoami, list, show, switch, logout, add/remove/revoke grants, token, scopes, providers, detect, migrate
Email (HIGH)
rules/email-commands.md— Read, send, search, mark, smart-compose, AI analyze, metadata, attachments, folders, threads, drafts, templates, scheduled
Calendar (HIGH)
rules/calendar-commands.md— Events CRUD, RSVP, availability, find-time, AI scheduling/analyze/conflicts/reschedule
Contacts (MEDIUM)
rules/contacts-commands.md— CRUD, search, sync, groups
Agent Accounts (HIGH)
rules/agent-commands.md— Managed email identities for AI agents:nylas agent account|policy|rule|statusandnylas workspace(groups accounts, attaches policies + condition/action rules)
Webhooks (HIGH)
rules/webhooks-commands.md— CRUD, triggers, test events, local webhook server
Dashboard (MEDIUM)
rules/dashboard-commands.md— Account (register/login/SSO/logout), apps, API keys, organizations
MCP & AI (HIGH)
rules/mcp-ai-commands.md— MCP install/status/serve for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, or all assistants; AI config (usage/budget)
Notetaker (MEDIUM)
rules/notetaker-commands.md— AI meeting bot list/create/show/media/delete workflows
OTP Codes (MEDIUM)
rules/otp-commands.md— Retrieve/watch 2FA one-time-password codes from email:nylas otp get|watch|list|messages
Audit Logging (MEDIUM)
rules/audit-commands.md— Init, enable/disable, view logs/summary, export, config
Tools & Interfaces (LOW)
rules/tools-interfaces.md— TUI, UI, Air web client, demo mode,nylas commandsmetadata, timezone utilities
Advanced Families (LOW)
rules/advanced-commands.md— Admin, scheduler, timezone, workflows, hosted templates, and GPG-related email feature docs