Nylas

Skill DrOlu/agent-skills/skills/nylas

Nylas CLI for unified email, calendar, and contacts via IMAP/SMTP, Google, and Microsoft 365. Use when reading, searching, composing, sending, or managing email from terminal, scheduling calendar events, managing contacts, extracting OTP codes, running MCP server for AI agents, or using the interactive TUI.From its SKILL.md

Install

npx -y skills add DrOlu/agent-skills --skill nylas

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

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 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.

SKILL.md

7.8 KB, ~2.1k tokens by cl100k_base, as published. Nobody here has run it

Nylas CLI — Unified Email, Calendar & Contacts

Quick Start

# List recent emails
nylas email list

# Send an email
nylas email send --to [email protected] --subject "Hello" --body "Hi there!" -y

# Search emails
nylas email search "invoice"

# Read a specific email
nylas email read <message-id>

# Check account health
nylas doctor

# Interactive TUI
nylas tui

Setup & Authentication

Install

brew install nylas/nylas-cli/nylas

First-time setup

# Interactive guided setup (opens browser for OAuth)
nylas init

# Or configure with existing API key
nylas auth config --api-key nyl_xxx

# Then authenticate with an email provider
nylas auth login --provider google     # Gmail
nylas auth login --provider microsoft  # Outlook/M365
nylas auth login --provider imap       # Generic IMAP (prompts for credentials)

IMAP setup (non-interactive)

expect -c '
set timeout 60
spawn nylas auth login --provider imap
expect "IMAP username"    ; send "[email protected]\r"
expect "IMAP password"    ; send "YOUR_PASSWORD\r"
expect "IMAP host"        ; send "mail.example.com\r"
expect "IMAP port"         ; send "993\r"
expect "Add SMTP"          ; send "Y\r"
expect "SMTP host"         ; send "mail.example.com\r"
expect "SMTP port"         ; send "465\r"
expect eof
'

Verify setup

nylas auth status    # Show current auth
nylas auth list      # List all accounts
nylas doctor         # Full health check

Core Email Commands

List emails

# Recent 10 from INBOX
nylas email list

# More emails
nylas email list --limit 50

# Unread only
nylas email list --unread

# From specific sender
nylas email list --from [email protected]

# Specific folder
nylas email list --folder SENT
nylas email list --folder TRASH

# All folders
nylas email list --all-folders

# Paginate through all
nylas email list --all --max 500

# JSON output for scripting
nylas email list --json
nylas email list --json --limit 50 | jq '.[].subject'

Read email

# Read a specific message
nylas email read <message-id>

# Show full headers
nylas email read <message-id> --headers

# Raw MIME source
nylas email read <message-id> --raw

# Mark as read after viewing
nylas email read <message-id> --mark-read

Search emails

# Full-text search
nylas email search "quarterly report"

# From specific person
nylas email search "from:[email protected]"

# Subject filter
nylas email search "subject:urgent"

# Date range
nylas email search "after:2026-01-01 before:2026-03-01"

# Unread
nylas email search "is:unread"

# Starred
nylas email search "is:starred"

# Has attachments
nylas email search "has:attachment"

Send email

# Simple send
nylas email send --to [email protected] --subject "Hello" --body "Hi there!" -y

# Multiple recipients
nylas email send --to [email protected] --to [email protected] --subject "Team update" --body "..." -y

# CC and BCC
nylas email send --to [email protected] --cc [email protected] --bcc [email protected] \
  --subject "FYI" --body "See attached" -y

# HTML body
nylas email send --to [email protected] --subject "Newsletter" \
  --body "<h1>Hello</h1><p>HTML content</p>" -y

# Scheduled send
nylas email send --to [email protected] --subject "Reminder" --body "..." --schedule "2h" -y
nylas email send --to [email protected] --subject "Morning" --body "..." --schedule "tomorrow 9am" -y

# With tracking
nylas email send --to [email protected] --subject "Proposal" --body "..." \
  --track-opens --track-links -y

# GPG sign
nylas email send --to [email protected] --subject "Secure" --body "..." --sign -y

# GPG encrypt
nylas email send --to [email protected] --subject "Confidential" --body "..." --encrypt -y

# Interactive mode (opens editor)
nylas email send --to [email protected] --subject "Draft" -i

Mark, move, delete

# Mark as read/unread
nylas email mark read <message-id>
nylas email mark unread <message-id>

# Star/unstar
nylas email mark starred <message-id>
nylas email mark unstarred <message-id>

# Delete
nylas email delete <message-id>

# Move to folder
nylas email move <message-id> --folder Archive

Calendar Commands

Note: Calendar requires Google or Microsoft 365 provider. IMAP does not support calendar.

# List calendars
nylas calendar calendars list

# List upcoming events
nylas calendar events list

# Create event
nylas calendar events create --title "Team standup" --when "tomorrow 9am" --duration 30m

# Create with attendees
nylas calendar events create --title "1:1" --when "friday 2pm" --duration 45m \
  --attendees [email protected],[email protected]

# Show event details
nylas calendar events show <event-id>

# Delete event
nylas calendar events delete <event-id>

Contact Commands

# List contacts
nylas contacts list

# Search contacts
nylas contacts list --query "john"

# JSON output
nylas contacts list --json

Folder Management

# List all folders
nylas email folders list

# Show folder with IDs
nylas email folders list --id

# Create a new folder
nylas email folders create --name "Projects"

# Rename a folder
nylas email folders rename --folder <folder-id> --name "Renamed"

# Delete a folder
nylas email folders delete --folder <folder-id>

OTP Extraction

# Get latest OTP code from email
nylas otp get

# Watch for new OTP codes
nylas otp watch

MCP Server (AI Integration)

# Start MCP server for Claude/Cursor/Windsurf
nylas mcp

# With specific transport
nylas mcp --transport stdio
nylas mcp --transport sse --port 8080

TUI (Interactive Mode)

# Launch interactive terminal UI
nylas tui

# Vim-style navigation: j/k to move, Enter to read, q to quit

Global Flags

Flag	Description
`--config <path>`	Custom config file path
`--format <fmt>`	Output format: `table`, `json`, `yaml`
`--json`	Shorthand for `--format json`
`--no-color`	Disable color output
`-q, --quiet`	Only output essential data (IDs)
`-v, --verbose`	Enable verbose output
`-w, --wide`	Show full IDs without truncation

Provider Support

Provider	Email	Calendar	Contacts	Auth
Google (Gmail)	✅	✅	✅	OAuth
Microsoft 365 (Outlook)	✅	✅	✅	OAuth
Exchange (EWS)	✅	✅	✅	OAuth
iCloud	✅	✅	✅	App password
Yahoo	✅	✅	✅	App password
IMAP/SMTP	✅	❌	❌	Credentials

Important Notes

IMAP provider supports email only — no calendar or contacts
Send uses --to, --subject, --body flags (unlike himalaya which takes raw RFC 5322)
Use -y flag to skip confirmation prompts in scripts
Use --json for scripting — all commands support JSON output
API key stored in system keyring — config at ~/.config/nylas/config.yaml
Free tier (Sandbox) has rate limits — 1 grant, limited API calls
Nylas routes email through its servers — not a direct IMAP client like himalaya
Demo mode available — nylas demo email list works without any account

References

references/cli-reference.md — Complete command reference for all nylas subcommands
references/config-reference.md — Config file format, multi-account setup, keyring, and provider templates
references/common-workflows.md — Search patterns, scheduled send, templates, MCP setup, and scripting patterns

What ships with it: 3 files

25.6 KB alongside SKILL.md

references/

Gives 0 of the 12 instructions most mcp tooling skills give in ~2.1k tokens

Counted across 638 of the 750 authors here whose files we hold, read 2026-08-07

Create ten complex or independent read-only evaluation questionsin 69 of 638, across 15 files
Test servers using MCP Inspectorin 61 of 638, across 19 files
Provide actionable error messages with specific next stepsin 54 of 638, across 12 files
Prioritize comprehensive API coverage over specific workflows or workflow toolsin 54 of 638, across 12 files
Use TypeScript and Streamable HTTP for remote servers or clientsin 54 of 638, across 8 files
Define structured output schemas where possiblein 50 of 638, across 8 files
Use Zod or Pydantic for input schemasin 47 of 638, across 5 files
Fetch MCP specification pages with markdown suffixin 46 of 638, across 4 files
Load framework documentation using WebFetchin 45 of 638, across 3 files
Verify each evaluation answer independentlyin 45 of 638, across 3 files
Implement API client with authentication and paginationin 45 of 638, across 3 files
Define input schemas with validationin 27 of 638, across 9 files

Said here and by no other author read

skip confirmation prompts with the -y flag
use --json flag for command output in scripts
use --to --subject and --body flags to send email
run nylas init for interactive guided setup
run nylas auth login with a specific provider

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

2 things to look at

SKILL.md

Nylas CLI — Unified Email, Calendar & Contacts

Quick Start

Setup & Authentication

Install

First-time setup

IMAP setup (non-interactive)

Verify setup

Core Email Commands

List emails

Read email

Search emails

Send email

Mark, move, delete

Calendar Commands

Contact Commands

Folder Management

OTP Extraction

MCP Server (AI Integration)

TUI (Interactive Mode)

Global Flags

Provider Support

Important Notes

References

What ships with it: 3 files

references/

Gives 0 of the 12 instructions most mcp tooling skills give in ~2.1k tokens

Said here and by no other author read

Keep looking