Source: https://cli.nylas.com/docs/commands/doctor

# nylas doctor

Run system diagnostics.

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## 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

```bash
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 |

## Examples

The nylas doctor command runs local diagnostics for the CLI, checking config, auth state, network access, and dependencies before deeper troubleshooting.

### Run a full diagnostics check

```bash
nylas doctor
```

### Run diagnostics with detailed output

```bash
nylas doctor --verbose
```

## Example output

```text
Nylas CLI Health Check

  ✓ Configuration - Region: us
  ✓ Secret Store - system keyring
  ✓ API Credentials - Configured
  ✓ Network - Connected (latency: 159ms)
  ⚠ Grants - 5 grant(s), default may be invalid

Summary

  1 warning(s), 4 passed

  Recommendations:
    - Run 'nylas auth list' to check grant status
```

## Troubleshooting

### 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.

## Related commands

[nylas airAI-powered email assistant. Opens an interactive REPL where you can draft, reply, search, and manage email with natural language.](https://cli.nylas.com/docs/commands/air)

[nylas completion bashGenerate shell completion script for bash, zsh, fish, or PowerShell.](https://cli.nylas.com/docs/commands/completion-bash)

[nylas completion fishGenerate Fish completion script](https://cli.nylas.com/docs/commands/completion-fish)

[nylas completion powershellGenerate PowerShell completion script.](https://cli.nylas.com/docs/commands/completion-powershell)

[nylas completion zshGenerate Zsh completion script](https://cli.nylas.com/docs/commands/completion-zsh)

[nylas config getGet a specific config value](https://cli.nylas.com/docs/commands/config-get)

## Recommended guides

[Getting Started with Agent AccountsHow Nylas Agent Account works. Architecture from Application to Workspace, inbound and outbound email flows, and why managed email replaces SMTP for AI agents.](https://cli.nylas.com/guides/getting-started-agent-accounts)

[Set Up an MCP Email Server in 5 MinutesConnect AI agents to real email accounts through MCP. Install, configure, and verify an email MCP server for Claude Code, Cursor, and other AI coding tools.](https://cli.nylas.com/guides/mcp-email-server-setup)

[Install Nylas Skills for AI Coding AgentsInstall 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.](https://cli.nylas.com/guides/nylas-agent-skills)

[Getting Started with the CLISet 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.](https://cli.nylas.com/guides/getting-started)

[Give Your AI Coding Agent an Email AddressConnect 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.](https://cli.nylas.com/guides/give-ai-agent-email-address)

[Automate Email with Manus AI: Beginner GuideFive-minute quickstart for Manus + Nylas CLI. Install the Skill, authenticate one mailbox, send a test email, list recent mail, and run your first search.](https://cli.nylas.com/guides/manus-ai-email-tutorial)

Run `nylas doctor --help` for full help output.