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": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mentraglass.com/mcp"]
    }
  }
}
Then restart Cursor.
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
Add to your VS Code settings.json:
{
  "mcp.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 mentraos-docs --transport http 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 any tool that supports MCP, use mcp-remote to connect to our HTTP endpoint: 
npx -y mcp-remote https://docs.mentraglass.com/mcp
Or if your tool supports HTTP MCP servers directly, use the URL: 
https://docs.mentraglass.com/mcp

​
Test It Out

After setup, try asking your AI assistant:
  • “How do I display text on smart glasses with MentraOS?”
  • “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

Make sure you have Node.js 18+ installed. The mcp-remote package requires it.
node --version  # Should be v18.0.0 or higher
Install Node.js from nodejs.org which includes npm and npx.
Try running the npx command with sudo on macOS/Linux, or run your terminal as Administrator on Windows.

​
What’s Next?

Quickstart

Build your first smart glasses app in 15 minutes

Example Apps

Clone a working example and start hacking