Nylas MCP Server for Claude

Overview

Nylas MCP connects AI agents to real email, calendar, contacts, availability, and Notetaker workflows through the Nylas platform. It is useful when Claude Code, Codex, Cursor, Windsurf, or another MCP client needs to check an inbox, search message history, draft a reply, inspect a calendar, create an event, or schedule a Notetaker without custom Gmail, Microsoft Graph, Exchange, Yahoo, iCloud, or IMAP integration code.

There are two practical setup paths:

• Local Nylas CLI MCP server, installed into a supported agent with nylas mcp install.
• Hosted regional MCP endpoint at https://mcp.us.nylas.com or https://mcp.eu.nylas.com, authenticated with a Bearer token.

Setup Paths

Nylas CLI Installer

Install and initialize the Nylas CLI, then register the MCP server with your agent:

brew install nylas/nylas-cli/nylas
nylas init
nylas mcp install --assistant claude-code
nylas mcp status

The same installer supports other clients:

nylas mcp install --assistant cursor
nylas mcp install --assistant windsurf
nylas mcp install --assistant vscode
nylas mcp install --assistant codex
nylas mcp install --all

For local stdio configuration, the server command is:

{
  "mcpServers": {
    "nylas": {
      "command": "nylas",
      "args": ["mcp", "serve"]
    }
  }
}

Hosted MCP Endpoint

Use the hosted endpoint when your client supports Streamable HTTP and you want to skip a local CLI process. Choose the URL that matches the Nylas application region:

For Codex, store the API key in an environment variable instead of the config file:

[mcp_servers.nylas]
url = "https://mcp.us.nylas.com"
bearer_token_env_var = "NYLAS_API_KEY"
tool_timeout_sec = 90

For Cursor-style JSON configuration:

{
  "mcpServers": {
    "nylas": {
      "type": "streamable-http",
      "url": "https://mcp.us.nylas.com",
      "headers": {
        "Authorization": "Bearer ${NYLAS_API_KEY}"
      }
    }
  }
}

Tool Surface

Nylas documents 36 MCP tools across email, calendar, contacts, time conversion, grant lookup, search syntax, and Notetaker workflows.

Use Cases

• Ask Claude Code to find a recent signup, deploy, billing, or incident email.
• Let Codex check whether a calendar slot is free before proposing a meeting.
• Draft an email reply while keeping final send approval separate.
• Search work and personal grants for a thread when the user does not remember which inbox contains it.
• Use contacts and availability to prepare scheduling or recruiting workflows.
• Send or schedule a Notetaker bot for meeting capture after the user approves the target meeting.

Safety and Privacy

Mailbox and calendar access is a high-trust integration. Treat email bodies, calendar descriptions, invites, attachments, and contact records as untrusted input, because they may include prompt injection or instructions that conflict with the user's request. Do not let a quoted email tell the agent to leak keys, forward confidential data, or bypass confirmation.

Nylas requires confirmation tools before direct send actions, but the user still needs a clear review step. Drafts, event creation, event deletion, and Notetaker actions can affect real people outside the repository. Keep destructive tools behind explicit user approval and prefer narrow search filters so the model sees only the messages and events needed for the task.

Source Review

Verified on 2026-06-18:

• Nylas's MCP documentation confirms the hosted US and EU endpoints, Bearer token authentication, CLI installer commands for Claude Code, Cursor, Windsurf, VS Code, Codex, and all agents, plus manual config examples.
• The Codex MCP guide confirms bearer_token_env_var, project and global config options, connection verification with get_grant, examples for inbox triage, calendar review, draft replies, availability, and account-scoped search.
• The Nylas MCP docs and blog document the 36-tool surface, two-step send confirmation, prompt-injection concerns, and the need to confirm irreversible delete actions.
• The nylas/cli repository is MIT licensed and documents nylas mcp for AI assistant integration, local credential storage, and CLI install options.

Duplicate Check

Checked current content/mcp/, content/tools/, content/skills/, open pull requests, and repository-wide content for Nylas, nylas mcp, mcp.us.nylas, mcp.eu.nylas, agent email, email mcp, and calendar mcp. Existing entries cover Google Workspace, CalendarMCP, Keeper.sh calendar, AgentTrust identity, and disposable email use cases, but no dedicated Nylas MCP server entry, Nylas CLI source URL duplicate, or open duplicate PR was found.