Nylas Documentation

One API for email, calendar, contacts, and scheduling across every provider. Connect your users’ accounts and build communication features in minutes.

Each account you connect becomes a grant: the same endpoints work across Gmail, Microsoft 365, iCloud, Yahoo, Exchange, and IMAP. Requests take an API key and a grant ID, against api.us.nylas.com or api.eu.nylas.com.

Get startedAPI referencecurl -fsSL https://cli.nylas.com/install.sh | bash

Ask Nyla, our docs AI. It writes working code in any Nylas SDK:

Send an email in Node.jsConnect a Microsoft accountHandle a message webhook

Start building

For developers

Build Nylas into your product. Your users connect their own mailbox and calendar through OAuth.

1. Create an application and API keyTwo minutes in the Dashboard, no card required.
2. Connect a user’s accountOAuth for Google, Microsoft, iCloud, Yahoo, or any IMAP host.
3. Send your first emailOne call against the grant you just created.

Then: create an event, embed scheduling, or subscribe to webhooks.

SDKs

Node.jsPythonRubyKotlin / Java

For AI agents

Give an agent its own mailbox and calendar. No browser, no OAuth flow, an API key is enough.

1. Install the Nylas skillTeaches Claude, Cursor, Codex, and 40+ agents the current API.
2. Create an Agent AccountA Nylas-hosted [email protected] mailbox and calendar.
3. Send from the agent’s own inboxOr read, reply, and schedule on it.

Then: the coding-agent quickstart, the MCP server, or the Nylas CLI.

Machine-readable

llms.txtopenapi.jsonPages as markdown

Nylas tooling

Nylas skill

Pre-load Claude, Cursor, Codex, and 40+ agents with current Nylas API context.

npx skills add nylas/skills

Nylas CLI

Connect accounts, send email, and run an MCP server from your terminal.

curl -fsSL https://cli.nylas.com/install.sh | bash

Claude Code plugin

One-command install for Claude Code users -- skills, slash commands, and all.

/plugin marketplace add nylas/skills

Explore by product

Email

Messages, threads, folders, and attachments across every provider.

Calendar

Events, availability, and free/busy across Google, Microsoft, and iCloud.

Scheduler

Embeddable scheduling UI components and booking APIs.

Notetaker

Meeting recording and transcription for Google Meet, Zoom, and Microsoft Teams.

Agent Accounts

A Nylas-hosted mailbox and calendar an agent owns outright, without OAuth.

Notifications

Webhooks, Pub/Sub, and SNS for message, event, and grant changes.

Popular guides

Monitor an inbox for support tickets

Watch a shared mailbox and turn each new thread into a ticket.

Automate meeting follow-up emails

Send a summary and next steps once a meeting ends.

Sync calendar events to a CRM

Keep records in step with a calendar in both directions.

Build an interview scheduling pipeline

Collect availability, book the slot, and notify everyone.

Add scheduling with automatic notetaking

Book a meeting and send Notetaker to record and transcribe it.

Browse all guides

Every recipe in the cookbook, by product and provider.

What’s new

Latest changes

Agent Account metadataAug 20, 2026Agent AccountsEmailCalendarAgent Accounts in SchedulerAug 20, 2026Agent AccountsSchedulerCalendariCloud CalDAV error code fixAug 19, 2026CalendarNotetaker transcript fixAug 19, 2026NotetakerCalendar owner_email fieldAug 18, 2026CalendarView all changelogs

From the community