Looking for end-to-end tutorials that combine multiple Nylas APIs? See Use cases .
The Nylas API gives you one interface for every provider, but each provider behaves differently. Folder structures, sync timing, rate limits, search capabilities, and authentication flows all vary depending on whether you’re working with Microsoft, Google, Yahoo, iCloud, IMAP, or Exchange.
These guides walk you through each provider’s specifics so you can build with confidence. Every guide focuses on a single task for a single provider, with code samples and the details that actually matter in production.
Guide Provider What you’ll do List Microsoft messages Microsoft 365, Outlook Retrieve and filter email from Microsoft accounts, handle folder naming, pagination, and sync behavior List Google messages Gmail, Google Workspace Retrieve and filter email from Google accounts, use Gmail search operators, handle labels, and manage OAuth scopes List Yahoo messages Yahoo Mail Retrieve and filter email from Yahoo accounts, handle the 90-day message cache, use query_imap for older messages List iCloud messages iCloud Mail Retrieve and filter email from iCloud accounts, handle app-specific passwords, the 90-day cache, and CalDAV vs. IMAP List IMAP messages Any IMAP server Retrieve and filter email from any IMAP provider (Zoho, Fastmail, AOL, custom servers), handle folder naming and UIDVALIDITY List Exchange messages Exchange on-premises Retrieve and filter email from self-hosted Exchange servers via EWS, handle message ID changes and AQS search
Guide Provider What you’ll do List Microsoft threads Microsoft 365, Outlook Retrieve and filter email threads from Microsoft accounts, understand ConversationId mapping, thread-level metadata, and folder behavior List Google threads Gmail, Google Workspace Retrieve and filter email threads from Google accounts, use native thread_id, handle labels on threads, and Gmail search operators List Yahoo threads Yahoo Mail Retrieve and filter email threads from Yahoo accounts, understand header-based thread grouping and the 90-day cache List iCloud threads iCloud Mail Retrieve and filter email threads from iCloud accounts, handle app-specific passwords and header-based threading List IMAP threads Any IMAP server Retrieve and filter email threads from any IMAP provider, understand header-based grouping and UIDVALIDITY List Exchange threads Exchange on-premises Retrieve and filter email threads from Exchange on-prem via EWS, handle ConversationId and message ID changes
Guide Provider What you’ll do List Microsoft events Microsoft 365, Outlook Retrieve and filter calendar events from Microsoft accounts, handle timezone normalization, Teams conferencing, and admin consent List Google events Google Calendar, Workspace Retrieve and filter calendar events from Google accounts, use event types, handle Google Meet conferencing, and manage OAuth scopes List iCloud events iCloud Calendar Retrieve and filter calendar events from iCloud accounts, handle app-specific passwords, CalDAV limitations, and the one-year range cap List Exchange events Exchange on-premises Retrieve and filter calendar events from self-hosted Exchange servers via EWS, handle on-prem networking and recurring event restrictions Create Microsoft events Microsoft 365, Outlook Create calendar events on Microsoft accounts, handle write scopes, Teams conferencing, participant notifications, and room resources Create Google events Google Calendar, Workspace Create calendar events on Google accounts, handle restricted scopes, Google Meet auto-create, and event type limitations Create iCloud events iCloud Calendar Create calendar events on iCloud accounts, handle app-specific passwords, CalDAV limitations, and the simpler event model Create Exchange events Exchange on-premises Create calendar events on Exchange on-prem via EWS, handle write scopes, recurring event restrictions, and on-prem networking
Guide Tool What you’ll do Use Nylas MCP with Claude Code Claude Code Connect Claude Code to the Nylas MCP server to manage email, calendar, and contacts from the terminal Use Nylas MCP with Codex CLI Codex CLI Connect OpenAI Codex CLI to the Nylas MCP server to manage email, calendar, and contacts from the terminal
Guide What you’ll do Install OpenClaw plugin Install and configure the @nylas/openclaw-nylas-plugin to give OpenClaw agents access to email, calendar, and contacts
Work with email, calendar, and contacts directly from the terminal without writing code. The Nylas CLI provides command-line access to the Nylas API for testing, debugging, and automation.
