Oculo MCP Server

Oculo is a full-Chromium desktop browser that speaks the Model Context Protocol. Point Claude Code, Cursor, Windsurf, or any MCP client at it and your agent can see and drive real web pages - read the DOM, click, fill forms, extract data, run multi-step pipelines - through 12 compact tools that answer in under 300 tokens per flow. It runs locally over stdio via the published package.

People connecting browser automation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-20 · ★ 5 · #147 OF 196 MAINTAINED BROWSER AUTOMATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Oculo

before you install - you'll need

OCULO_HEADLESS

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add xidik12-oculo -- npx -y oculo-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "xidik12-oculo": {
      "command": "npx",
      "args": [
        "-y",
        "oculo-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package oculo-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.xidik12 is GitHub-verified and matches the repo owner

03 · What Oculo can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.4.4 · 2026-03-10

What's New · Google Sign-In Fix (Permanent) - Replaced Electron's <webview> tags with the WebContentsView API. Tabs are now top-level Chromium web contents, identical to real Chrome tabs. Google (and other sites) can…

v0.4.3 · 2026-03-09

Oculo v0.4.3 - Cross-Platform Fix & Auth Isolation · Windows installer now works - Previous builds were ARM64 (built on M-series Mac), now correctly targets x64 · Google sign-in unblocked - Added…

v0.4.1 · 2026-03-09

What's New · UX Overhaul - Post a tweet in 1 tool call instead of 15. · Changes · /health endpoint - Fixes bridge always deleting port file (critical bug fix) · Bridge connection caching - 30s TTL + auto-retry on…

04 · Who maintains Oculo

oculo is maintained by xidik12. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/xidik12/oculo
category: browser automation - ranked #147 of 196 actively-maintained browser automation servers as of 2026-08-25.
registry: io.github.xidik12/oculo (active, first published 2026-03-09)
packages: npm:oculo-mcp

06 · Oculo FAQ

What is Oculo?

Is Oculo still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-20. We re-verify nightly.

How do I install Oculo?

Run `npx -y oculo-mcp`. The README documents one environment variable (OCULO_HEADLESS) to set first. You can also paste the ready-made client config above.

Does Oculo run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Oculo

Alternatives to Oculo

Maintained browser automation servers if Oculo isn't the fit.

Pairs well with

Servers that cover what Oculo doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · DeepSeek Visionary · Open Computer Use · Md Feedback · Aginx Browser · One Search MCP

More TypeScript MCP servers · Skill Deck · Markdown Formatter · Tc39 MCP · Wasm MCP · Hardware Probe · see all