Command

nylas mcp status

Check the status of the Nylas MCP server.

Written by Qasim Muhammad Staff SRE

What does nylas mcp status do?

The nylas mcp status command reports whether the MCP server is running, which transport mode it uses, how many tools are registered, and the connected grant. Use it to verify that your AI assistant can reach the Nylas MCP server and that email, calendar, and contact tools are available.

Usage

nylas mcp status

Flags

FlagDescription
--jsonOutput as JSON
--no-colorDisable color output
--verbose(-v)Enable verbose output
--configCustom config file path
--help(-h)Show help for the command
--limitLimit results (most list commands)
--yes(-y)Skip confirmations

Examples

The nylas mcp status command reports whether the MCP server is running, which transport mode it uses, how many tools are registered, and the connected grant.

Check MCP server status

nylas mcp status

Verify tools are registered

nylas mcp status --json | jq '.tools'

Example output

MCP Installation Status:

  ○ Claude Desktop    config exists, nylas not added  /Users/you/Library/Application Support/Claude/claude_desktop_config.json
  ○ Claude Code       config exists, nylas not added  /Users/you/.claude.json
  ○ Cursor            not configured  /Users/you/.cursor/mcp.json
  - Windsurf          application not installed

Legend:
  ✓ Nylas MCP configured
  ○ Available but not configured
  - Not available

Troubleshooting

Status shows no tools registered

Run nylas auth login to connect an account. Tools are registered only when a valid grant exists.

Status shows server not running

Start the server with nylas mcp serve. If it was running, check logs for crash details with --verbose.

Recommended guides

Build a Strands Email Agent

Give a Strands Agents SDK agent email access using the Nylas CLI as a @tool. One function reaches Gmail, Outlook, and 4 more providers — no OAuth code needed.

Cloudflare Agents Email Tools

Use the Cloudflare Agents SDK to build a stateful email agent on Workers — connect to the Nylas MCP server over HTTP and call email tools in TypeScript.

AI Calendar Assistant from the Terminal

Use nylas calendar schedule ai and calendar ai for natural-language scheduling, focus-time protection, conflict resolution, and meeting-context extraction.

Set Up an MCP Calendar Server

Expose calendar tools to an AI client over MCP. Install nylas mcp, configure your assistant, and let it check availability and create events.

Give an AI Agent Calendar Access

Wrap nylas calendar availability and events as agent tools: read-only by default, draft-before-create for writes, and an OAuth scope the agent can't widen.

Set Up an MCP Contacts Server

Expose contact search and read tools to an AI client over MCP with nylas mcp install. Configure, verify, and call address-book tools.

Run nylas mcp status --help for full help output.