Command

nylas email read

Read a specific email. Supports decryption and signature verification.

Usage

nylas email read <message-id> [grant-id] [options]

Flags

Flag	Description
--json	Output as JSON
--no-color	Disable color output
--verbose(-v)	Enable verbose output
--config	Custom config file path
--help(-h)	Show help for the command
--limit	Limit results (most list commands)
--yes(-y)	Skip confirmations
--raw	Show raw body without HTML
--mime	Show raw RFC822/MIME format
--decrypt	Decrypt PGP-encrypted email
--verify	Verify GPG signature
--mark-read	Mark as read after reading

Examples

Read email

nylas email read msg_abc123

Decrypt and verify

nylas email read msg_xyz789 --decrypt --verify

Inbound inbox (with grant)

nylas email read msg_xyz123 inbox_abc123 --json

Troubleshooting

Message not found

Verify the message ID. For Inbound, ensure you pass the inbox (grant) ID.

Recommended guides

List Exchange Emails from the Command Line

List, search, and filter Microsoft Exchange and Exchange Online emails from your terminal. No EWS or PowerShell required. OAuth2 built in.

List IMAP Emails from the Command Line

List, search, and filter emails from any IMAP server from your terminal. Works with Fastmail, ProtonMail Bridge, Zoho, and any IMAP-compatible provider.

List iCloud Mail Emails from the Command Line

List, search, and filter iCloud Mail emails from your terminal. No app-specific passwords or IMAP config. One command setup.

List Yahoo Mail Emails from the Command Line

List, search, and filter Yahoo Mail emails from your terminal. One command, no app passwords or IMAP config. OAuth2 built in.

List Outlook Emails from the Command Line

List, search, and filter Outlook and Microsoft 365 emails from your terminal. No Microsoft Graph API setup. OAuth2 built in.

List Gmail Emails from the Command Line

List, search, and filter Gmail emails from your terminal. One command, no Google API setup. Works with OAuth2 out of the box.

Create a Manus Skill for Email and Calendar

Build a Manus AI Skill that gives your agent email and calendar access using the Nylas CLI.

Nylas CLI with OpenClaw Personal Assistant

Give your OpenClaw assistant email, calendar, and contacts superpowers. Includes exec-approvals.json setup and a ready-made Nylas skill.

GPG Encrypted Email from the CLI

Sign, encrypt, and verify email with GPG. Auto-fetches keys from public keyservers.

E2E Email Testing with Playwright

Send and verify transactional emails in tests. Poll with the CLI, parse content, click links.

Build an LLM Agent with Email and Calendar Tools

Add email and calendar tools to your custom agent. Use Nylas CLI as subprocess tools. No API code.

Send Email from the Terminal

Send, read, search, and automate email from your terminal. Works with Gmail, Outlook, and IMAP.

Run nylas email read --help for full help output.