Command

nylas doctor

Run system diagnostics.

Written by Qasim Muhammad Staff SRE

Published February 13, 2026Updated 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

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

Run a full diagnostics check

nylas doctor

Run diagnostics with detailed output

nylas doctor --verbose

Example output

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.

Recommended guides

Getting Started with Agent Accounts

How Nylas Agent Account works. Architecture from Application to Workspace, inbound and outbound email flows, and why managed email replaces SMTP for AI agents.

Set Up an MCP Email Server in 5 Minutes

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

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.