Skip to main content
TL;DR - Get your AI coding assistant to understand MentraOS instantly. Works with Zed, Cursor, VS Code, Windsurf, Claude Code, and more.

Why Connect Your AI IDE?

When you connect your AI coding assistant to MentraOS docs, it can:
  • Answer questions about the MentraOS SDK
  • Help you write smart glasses apps faster
  • Look up API references automatically
  • Debug your code with context about how MentraOS works

MCP Server URL

All setups below use this URL:
https://docs.mentraglass.com/mcp

Setup by IDE

Zed

Add this to your settings.json (open with Cmd+, or zed: open settings):
{
  "context_servers": {
    "mentraos-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mentraglass.com/mcp"],
      "env": {}
    }
  }
}
Restart Zed and you’re done.
Open the Agent Panel and check the MCP servers indicator in settings. A green dot means the server is active. You can also type / in a chat to see available prompts from the server.

Cursor

Add this to your Cursor MCP config file at ~/.cursor/mcp.json (create it if it doesn’t exist):
{
  "mcpServers": {
    "mentraos-docs": {
      "url": "https://docs.mentraglass.com/mcp"
    }
  }
}
Then restart Cursor and approve the MCP server if prompted.
You can also create .cursor/mcp.json in your project root to enable MentraOS docs only for that project.

VS Code (with GitHub Copilot)

VS Code 1.99+ has built-in MCP support with GitHub Copilot.
  1. Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
  2. Run “MCP: Add Server”
  3. Select “HTTP” as the transport type
  4. Enter URL: https://docs.mentraglass.com/mcp
  5. Name it mentraos-docs
Create .vscode/mcp.json in your project and add:
{
  "servers": {
    "mentraos-docs": {
      "type": "http",
      "url": "https://docs.mentraglass.com/mcp"
    }
  }
}

Windsurf

  1. Open Windsurf Settings (Cmd+, / Ctrl+,)
  2. Search for “MCP” and click to open the Manage Plugins panel
  3. Click “View raw config” to open mcp_config.json
  4. Add the following configuration:
{
  "mcpServers": {
    "mentraos-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mentraglass.com/mcp"]
    }
  }
}
  1. Click Refresh in the Manage Plugins panel
  • macOS: ~/.codeium/windsurf/mcp_config.json
  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Claude Code (CLI)

Run this in your terminal:
claude mcp add --transport http mentraos-docs https://docs.mentraglass.com/mcp
Run claude mcp list to see your connected servers. You should see mentraos-docs in the list.

Other MCP-Compatible Tools

For tools that support remote HTTP MCP servers, use this URL directly:
https://docs.mentraglass.com/mcp
If your tool only supports command-based local MCP servers, use mcp-remote:
npx -y mcp-remote https://docs.mentraglass.com/mcp

Test It Out

After setup, try asking your AI assistant:
  • “How do I stream video from Mentra Live?”
  • “Show me how to use the camera API”
  • “What events can I listen to in an AppSession?”
  • “How do I listen for metric system setting changes?”
Your AI should now give you accurate, up-to-date answers using our docs.

Troubleshooting

If your setup uses mcp-remote, make sure you have Node.js 18+ installed.
node --version  # Should be v18.0.0 or higher
Install Node.js from nodejs.org which includes npm and npx.
Fix your Node.js package permissions with a version manager or npm prefix configuration instead of running downloaded packages with sudo.

What’s Next?

Quickstart

Connect to Mentra Live and read glasses status

Example Apps

Run the Android, iOS, and React Native starter apps