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:Setup by IDE
Zed
Add this to yoursettings.json (open with Cmd+, or zed: open settings):
How to verify it's working
How to verify it's working
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):
Alternative: Project-level config
Alternative: Project-level config
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.- Open Command Palette (
Cmd+Shift+P/Ctrl+Shift+P) - Run “MCP: Add Server”
- Select “HTTP” as the transport type
- Enter URL:
https://docs.mentraglass.com/mcp - Name it
mentraos-docs
Manual configuration
Manual configuration
Create
.vscode/mcp.json in your project and add:Windsurf
- Open Windsurf Settings (
Cmd+,/Ctrl+,) - Search for “MCP” and click to open the Manage Plugins panel
- Click “View raw config” to open
mcp_config.json - Add the following configuration:
- Click Refresh in the Manage Plugins panel
Config file location
Config file location
- macOS:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
Claude Code (CLI)
Run this in your terminal:Verify it worked
Verify it worked
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:mcp-remote:
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?”
Troubleshooting
Server not connecting
Server not connecting
If your setup uses
mcp-remote, make sure you have Node.js 18+ installed.npx command not found
npx command not found
Install Node.js from nodejs.org which includes npm and npx.
Permission errors
Permission errors
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

