@nylas/helix-mcp-server
v0.1.4
Published
MCP server and CLI for Nylas Helix — email, calendar, contacts, and identity context for AI agents.
Readme
@nylas/helix-mcp-server
MCP server and CLI for Nylas Helix — email, calendar, contacts, and identity context for AI agents.
Quick Start
npx @nylas/helix-mcp-server@latest --setupThis registers Helix as an MCP server in Claude Code using the OAuth 2.0 device code flow:
- Registers as an OAuth client with your Helix instance
- Displays a code and opens the browser for approval
- Polls until you approve the scopes
- Registers the MCP endpoint with
claude mcp add
Restart Claude Code after setup to activate.
Commands
npx @nylas/helix-mcp-server --setup # Set up Helix MCP in Claude Code
npx @nylas/helix-mcp-server --uninstall # Remove Helix MCP from Claude CodeWhat It Provides
Once connected, Claude Code gets tools for:
- Email — read threads, search, send (approval-gated)
- Calendar — read events, create events (approval-gated)
- Contacts — search contacts
- Identity — read identity config, pending actions, approve/reject
All actions respect the permissions and approval policies configured in your Helix identity.
Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| HELIX_URL | https://helix.nylas.com | Helix instance URL (for self-hosted or local dev) |
Uninstall
npx @nylas/helix-mcp-server --uninstallLicense
MIT
