Command
nylas doctor
The nylas doctor command runs local diagnostics for the CLI, checking config, auth state, network access, and dependencies before deeper troubleshooting.
Written by Qasim Muhammad Staff SRE
What does nylas doctor do?
The nylas doctor command runs local diagnostics for the CLI, checking config, auth state, network access, and dependencies before deeper troubleshooting.
Usage
nylas doctor [flags]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 |
| --format | Output format: table, json, yaml |
| --quiet(-q) | Quiet mode - only output essential data (IDs) |
| --wide(-w) | Wide output - show full IDs without truncation |
Examples
Run a full diagnostics check
nylas doctorRun diagnostics with detailed output
nylas doctor --verboseTroubleshooting
Doctor reports auth or config problems
Re-run `nylas auth config` or `nylas auth login` based on the reported failure, then execute `nylas doctor` again.
Recommended guides
Install Nylas Skills for AI Coding Agents
Install nylas-cli and nylas-api skills in Claude Code, Cursor, Codex CLI, Windsurf, and 30+ AI coding agents. One command adds email and calendar tools.
Getting Started with the CLI
Set up Nylas CLI in under 2 minutes. Create a free Nylas account, get an API key from the dashboard, and run nylas auth config. No browser auth flow needed.
Give Your AI Coding Agent an Email Address
Connect Claude Code, Cursor, OpenAI Codex CLI, Windsurf, and OpenClaw to a real email account via MCP. Step-by-step setup for each tool using Nylas CLI.
Automate Email with Manus AI: Beginner Guide
Five-minute quickstart for Manus + Nylas CLI. Install the Skill, authenticate one mailbox, send a test email, list recent mail, and run your first search.
Run nylas doctor --help for full help output.