nylas-api skill
Integrate email, calendar, and contacts functionality into applications using the Nylas v3 API and supported SDKs.
- GitHub stars
- 11
- Files
- 22
- Last commit
- Oct 5, 2026
- License
- MIT
- Allowed tools
- —
What does the nylas-api skill do?
nylas-api integrates email, calendar, and contacts functionality into applications using the Nylas v3 API and supported SDKs.
Summary generated from the skill's SKILL.md.
About the nylas-api skill
Developers building applications that require email, calendar, and contacts functionality can use this skill to implement the Nylas v3 API. It provides integration-authoring guidance for managing authenticated user accounts, known as grants, across providers like Google, Microsoft, and iCloud. When an agent needs to write code using nylas-python, @nylas/nylas, or other supported SDKs for Node.js, Ruby, and Kotlin/Java, it can load this skill to access specific implementation rules.
The skill covers a wide range of features including message threading, smart compose, event availability, and contact management. It also includes technical details for advanced features like webhooks, the scheduler API, and the notetaker meeting bot. Users must provide a Nylas API key from the v3 dashboard to utilize these integrations. The documentation emphasizes security by treating grant-scoped data as untrusted and provides guidance on managing agent accounts and transactional sending.
What an agent can do with it
- 1Implement email and calendar featuresWrite code to manage email threads, drafts, and calendar event availability using the v3 API.
- 2Configure OAuth authentication flowsSet up secure authentication for various providers including Google, Microsoft, and Yahoo.
- 3Develop automated meeting toolsIntegrate meeting bots and AI-generated notes into an application via the notetaker API.
- 4Set up real-time notificationsImplement webhooks and Pub/Sub triggers to respond to changes in user data.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the nylas-api skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the nylas-api skill in Plugin
/plugin marketplace add nylas/skills /plugin install nylas-skills@nylas-skills
Install the nylas-api skill in Claude Code
~/.claude/skills/nylas-api/SKILL.md
$ npx degit nylas/skills/skills/nylas-api ~/.claude/skills/nylas-apiInstall the nylas-api skill in Claude Code (project)
.claude/skills/nylas-api/SKILL.md
$ npx degit nylas/skills/skills/nylas-api .claude/skills/nylas-apiInstall the nylas-api skill in Codex
~/.agents/skills/nylas-api/SKILL.md
$ npx degit nylas/skills/skills/nylas-api ~/.agents/skills/nylas-apiInstall the nylas-api skill in Gemini CLI
~/.gemini/skills/nylas-api/SKILL.md
$ npx degit nylas/skills/skills/nylas-api ~/.gemini/skills/nylas-apiInstall the nylas-api skill in Claude.ai
npx degit nylas/skills/skills/nylas-api nylas-api && zip -r nylas-api.zip nylas-api # claude.ai → Customize → Skills → + → Create skill → Upload a skill → nylas-api.zip
SKILL.md
View on GitHubNylas 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 | Docsrules/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, idempotent send | Docsrules/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
Files in this skill
22nylas-api skill questions
How do I install the nylas-api skill in Claude Code?
Run npx degit nylas/skills/skills/nylas-api ~/.claude/skills/nylas-api. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the nylas-api skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
Which version of the Nylas API should I use?
You should always use v3, as the v2 API is deprecated.
What programming languages are supported by Nylas SDKs?
Nylas provides SDKs for Node.js, Python, Ruby, and Kotlin/Java.
What is a 'grant' in the context of Nylas?
A grant refers to an authenticated user account, such as Gmail or Outlook, that has been connected through Nylas.