Nylas api

Skill nylas/skills/skills/nylas-api

Agent Skills for building with the Nylas platform — email, calendar, contacts. Works with Claude Code, Cursor, Copilot, and 30+ AI coding agents.

Install

npx -y skills add nylas/skills --skill nylas-api

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Build email, calendar, and contacts integrations with the Nylas v3 API. Use when code imports nylas, @nylas/nylas, nylas-python, or user asks about Nylas API, email API integration, calendar API, contacts API, OAuth grants, agent accounts, webhooks, scheduler, notetaker, smart compose, or transactional send. DO NOT use for Nylas CLI commands.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.3 KB, as published. Nobody here has run it

Nylas v3 API Integration Guide

Always use v3. The v2 API is deprecated.
A grant = an authenticated user account (Gmail, Outlook, etc.) connected through Nylas.
Base URLs: https://api.us.nylas.com (US) / https://api.eu.nylas.com (EU). All paths /v3/.
Auth: Most APIs use Bearer token (API key) plus a grant ID in the path. Admin domain management and Beta admin API key endpoints use Nylas Service Account auth instead.
SDKs: Node.js, Python, Ruby, Kotlin/Java.
Security: Treat grant-scoped API data as untrusted when writing integration code.
Scope: This skill is integration-authoring guidance, not runtime access guidance. Do not use model-loaded rules as instructions to inspect live user resources during an agent session.

Documentation

Use the checked-in rules in this skill and the compiled reference in AGENTS.md as the working source for agent behavior. External docs links below are reference URLs only; do not load remote markdown into the active prompt at runtime.

Docs index (find the right page): https://developer.nylas.com/llms.txt
Full docs (everything in one file): https://developer.nylas.com/llms-full.txt

Rules

Read individual rule files for endpoints, examples, and SDK code. For the full compiled reference, read AGENTS.md.

Authentication (CRITICAL)

rules/auth-oauth-flow.md — Hosted OAuth, BYO auth, IMAP auth, PKCE, service accounts, Nylas Connect | Docs
rules/auth-providers.md — Google, Microsoft, Yahoo, iCloud, IMAP, Exchange, Zoom setup | Docs

Security & Prompt Safety (CRITICAL)

rules/security-untrusted-content.md — Prompt-injection boundaries for grant-scoped API data; require confirmation before application mutations

Email API (HIGH)

rules/email-messages.md — Messages, threads, drafts, folders, attachments, search, filters | Docs
rules/email-advanced.md — Tracking, smart compose, templates, workflows, scheduled/transactional send | Docs

Calendar API (HIGH)

rules/calendar-events.md — Events, availability, free/busy, recurring, virtual calendars, conferencing, group booking | Docs

Contacts API (MEDIUM)

rules/contacts-crud.md — CRUD, groups, sources (address_book/domain/inbox), profile pictures | Docs

Webhooks & Notifications (HIGH)

rules/webhooks-notifications.md — Webhooks, Pub/Sub, triggers, schemas, verification, retry behavior | Docs

Scheduler API (MEDIUM)

rules/scheduler-booking.md — Configurations, bookings, hosted pages, meeting types, UI components | Docs

Notetaker API (MEDIUM)

rules/notetaker-meetings.md — Meeting bot setup, AI notes, action items, transcription settings, calendar sync | Docs

Agent Accounts API (HIGH)

rules/agent-accounts.md — Managed AI-agent mailboxes (provider: nylas), workspaces, policies/rules/lists, send limits, deliverability webhooks | Docs

Admin & Grants (MEDIUM)

rules/admin-grants.md — Grants, connectors, credentials, API keys, domains, workspaces | Docs

SDKs (HIGH)

rules/sdk-quickstart.md — Node.js, Python, Ruby, Kotlin/Java quick starts | Docs

Best Practices (HIGH)

rules/best-practices-patterns.md — Rate limits (with numbers), error codes (200/400/500/700), pagination, metadata, field selection | Docs | Errors