Hosted Server (Recommended) The fastest way to get started — no installation required.
Generate an API Key
Open the Omi app and navigate to Settings → Developer → MCP to generate your API key. Your key will look like: omi_mcp_... This key is only for MCP clients. To call REST Developer API endpoints directly, create a separate
Developer API key from Settings → Developer → Create Key . Developer API keys look like
omi_dev_....
Configure Your Client
Use the following connection details:
Server URL: https://api.omi.me/v1/mcp/sseAuthorization: Bearer omi_mcp_... (your generated key)Transport: Streamable HTTP (MCP 2025-03-26 spec) Client Configuration
Add to your claude_desktop_config.json: { "mcpServers" : { "omi" : { "url" : "https://api.omi.me/v1/mcp/sse" , "headers" : { "Authorization" : "Bearer omi_mcp_YOUR_KEY_HERE" } } } }
Config file location:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Go to Cursor Settings → MCP and add a new server:
Name: OmiTransport: SSEURL: https://api.omi.me/v1/mcp/sseHeaders: Authorization: Bearer omi_mcp_YOUR_KEY_HERE Enter the server URL and API key in Poke’s MCP connection settings. Any MCP client that supports the Streamable HTTP transport (2025-03-26 spec) will work: # Endpoint POST https://api.omi.me/v1/mcp/sse # Headers Authorization: Bearer omi_mcp_YOUR_KEY_HERE Content-Type: application/json Accept: text/event-stream # for SSE responses # Body (JSON-RPC 2.0) { "jsonrpc" : "2.0", "id": 1, "method": "initialize", "params": {}}
Docker (Self-Hosted) If you prefer to run the MCP server locally:
Generate an API Key
Open the Omi app → Settings → Developer → MCP to generate your key.
Install Docker
Install Docker. We recommend OrbStack for macOS.
Configure Claude Desktop
Add to your claude_desktop_config.json: { "mcpServers" : { "omi" : { "command" : "docker" , "args" : [ "run" , "--rm" , "-i" , "-e" , "OMI_API_KEY=omi_mcp_YOUR_KEY_HERE" , "omiai/mcp-server" ] } } }
The API key can also be provided with each tool call. If not provided, the server uses the OMI_API_KEY environment variable as a fallback.
Custom Backend URL If you are self-hosting the Omi backend:
export OMI_API_BASE_URL = "https://your-backend-url.com"
Only needed for self-hosted Omi instances. The default URL points to the official Omi API.
