Skip to content
/ cli Public

Nylas CLI is a unified command-line tool for Nylas API authentication, email management (GPG signing/encryption), calendar, contacts, webhooks, timezone utilities, and OTP extraction

License

Notifications You must be signed in to change notification settings

nylas/cli

Repository files navigation

Nylas CLI

Go Version License Release

Unified CLI for Nylas API - manage email, calendar, and contacts across providers (Google, Microsoft, IMAP) with a single interface.

Installation

Homebrew (macOS/Linux):

brew install nylas/nylas-cli/nylas

Go Install:

go install github.com/nylas/cli/cmd/nylas@latest

Binary: Download from Releases and add to PATH.

Getting Started

Just want to explore? Try the demo first - no credentials needed:

nylas tui --demo

Ready to connect your account? Get API credentials (free tier available), then:

nylas auth config    # Enter your API key
nylas auth login     # Connect your email provider
nylas email list     # You're ready!

Basic Commands

Command Example
Email nylas email list, nylas email send --to user@example.com
Calendar nylas calendar events list
Contacts nylas contacts list
Webhooks nylas webhook list
TUI nylas tui (interactive terminal, vim keys, 9 themes)
Web UI nylas air (browser interface)

Full Command Reference → | All Documentation →

Features

  • Email: list, read, send, search, templates, GPG signing/encryption
  • Calendar: events, availability, timezone conversion, AI scheduling
  • Contacts: list, create, groups
  • Webhooks: create, test, manage
  • Timezone: ⚡ offline conversion, DST info, meeting finder (no API required)
  • Admin: applications, connectors, credentials, grants
  • Integrations: MCP (AI assistants)
  • Interfaces: CLI, TUI (terminal), Air (web)

Timezone Tools (No API Required)

nylas timezone convert --from PST --to IST     # Convert time
nylas timezone dst --zone America/New_York     # Check DST transitions
nylas timezone find-meeting --zones "NYC,LON"  # Find meeting times

Configuration

Credentials stored securely in system keyring (macOS Keychain, Linux Secret Service, Windows Credential Manager).

Config file: ~/.config/nylas/config.yaml

Development

make build      # Build binary
make ci         # Quality checks (fmt, vet, lint, test, security)
make ci-full    # Complete CI (quality + integration tests)

Development Guide | Contributing

API Reference

This CLI uses the Nylas v3 API.

License

MIT

About

Nylas CLI is a unified command-line tool for Nylas API authentication, email management (GPG signing/encryption), calendar, contacts, webhooks, timezone utilities, and OTP extraction

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 5