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](https://github.com/xidik12/getoculo.com/releases/download/v0.2.0/Oculo-0.2.0-arm64.dmg) |
| **macOS** (Apple Silicon, zip) | [Oculo-0.2.0-arm64-mac.zip](https://github.com/xidik12/getoculo.com/releases/download/v0.2.0/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**
```bash
claude mcp add oculo -- node /path/to/mcp/oculo-mcp.mjs
```
**Cursor** — add to `.cursor/mcp.json`:
```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](LICENSE) © 2026 Salakhitdinov Khidayotullo