Oculo

Download for macOS  ·  Website  ·  MCP Setup  ·  Donate

---

What is Oculo?

Oculo is a native, AI-first browser (built on Electron) that plugs into any MCP client and lets your AI assistant see and operate real web pages — read the page, click, type, fill forms, navigate, screenshot, and generate media.

Point Claude Code, Cursor, Windsurf, Zed, or any MCP-compatible client at Oculo and it gains a browser it can actually drive.

Cursor : VS Code :: Oculo : Chrome

Why it's different

• Token-lean by design. A full page description is about ~30 tokens — headings, forms, buttons, and links, not raw DOM. Your agent stays cheap and fast.
• 7 tools, not 70. One small, composable tool set (page act fill read run media shell) covers browsing end to end.
• Any MCP client. No lock-in — Oculo speaks standard MCP over stdio, so it works everywhere MCP does.
• Privacy-first. A 4-tier permission gate, PII redaction, anti-injection guards, an audit log, and a Keychain-backed credential vault sit between the agent and your data.

How it works

Oculo runs as a normal desktop browser with an embedded HTTP MCP server. A tiny stdio bridge (mcp/oculo-mcp.mjs) connects your MCP client to it — the app publishes its port and auth token to ~/.oculo-port, and the bridge reads that to connect.

Features

• AI Chat Panel — multi-provider: Claude, OpenAI, Gemini, Grok, OpenClaw, Ollama.
• 7 MCP Tools — universal MCP integration, ~30 tokens per page description.
• Media Generation — Nano Banana images, Veo 3.1 video.
• Smart Auth — credential vault (macOS Keychain), auto-login, TOTP 2FA.
• Privacy & Security — 4-tier permission gate, PII redaction, anti-injection, audit log.
• Voice Control — on-device Whisper speech-to-text for voice commands.
• Shell — run browser-side JavaScript, sandboxed and permission-gated.

Download

Platform	File
macOS (Apple Silicon)	Oculo-0.2.0-arm64.dmg
macOS (Apple Silicon, zip)	Oculo-0.2.0-arm64-mac.zip

Windows & Linux coming soon.

Connect any MCP client

Launch the Oculo app first, then wire up your client.

Claude Code

claude mcp add oculo -- node /path/to/mcp/oculo-mcp.mjs

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "oculo": {
      "command": "node",
      "args": ["/path/to/mcp/oculo-mcp.mjs"]
    }
  }
}

Any stdio MCP client — point it at node /path/to/mcp/oculo-mcp.mjs over the stdio transport.

The 7 tools

Tool	What it does	Tokens
page	Describe the current page (headings, forms, buttons, links)	~30
act	Navigate, click, type, scroll, screenshot, login	~10
fill	Fill form fields by label matching	~15
read	Extract structured data (lists, tables, cards)	~100
run	Multi-step pipeline in a single call	~200
media	Generate images / videos from text prompts	varies
shell	Execute browser-side JavaScript (sandboxed)	~50

Tech stack

Electron 34 · TypeScript · React 19 · Tailwind CSS · MCP SDK · Whisper (on-device voice)

Support

Oculo is free. If it's useful to you, consider supporting development:

Bitcoin (BTC): 12yRGpUfFznzZoz4yVfZKRxLSkAwbanw2B

License

MIT © 2026 Salakhitdinov Khidayotullo