Octoweb MCP
macOS browser on WebKit and Rust: keyboard-first, with a built-in assistant and an MCP server an agent uses to drive the browser
- 144 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- The agent gets access to your tabs and can run JavaScript on pages, click buttons and submit forms in your profile
- A local MCP server with no auth listens on port 3434, so any process on the machine can drive it
Install
- Works in
Manual install
brew install --cask muvon/tap/octowebCommand from the README. Then add the `http://localhost:3434/mcp` server to the MCP client while Octoweb is running. A DMG for Apple Silicon is also offered.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent gets access to your tabs and can run JavaScript on pages, click buttons and submit forms in your profile
- A local MCP server with no auth listens on port 3434, so any process on the machine can drive it
This is third-party code. Review the repository files before installing.
What it does
Octoweb is a macOS-only browser built on WebKit and Rust, with no Electron or Chrome and no mouse required. Every action has a shortcut, the command palette (`⌘⇧P`) searches tabs and history, and any page can be pinned to a quick slot. An AI assistant lives in a sidebar and runs through the local octomind agent server. An MCP server starts inside the browser at `localhost:3434/mcp` over HTTP JSON-RPC. Claude Desktop, octomind or any MCP client can connect to it. Tools include `browser_navigate`, `browser_snapshot` (a map of interactive elements), `browser_get_page_content`, `browser_execute_js`, `browser_click`, `browser_type`, `browser_fill_form`, `browser_wait`, tab control, scrolling, hovering and more. Navigation runs in the background and never steals focus, `javascript:`, `data:`, `blob:` and `file:` schemes are refused, and `browser_dismiss_overlay` closes consent overlays and prefers Reject. There is page memory (search over the text of visited pages, with private tabs never indexed), a read-later queue and markdown copying for sharing. Install with `brew install --cask muvon/tap/octoweb` or the DMG for Apple Silicon.
Who it is for. macOS users who work from the keyboard and want to give an agent control of a real browser, and developers of web automation over MCP.
Good fit when
- An agent has to drive a browser on your Mac: open pages, read content, click and fill in forms
- Search over text of already visited pages should also be available to the agent over MCP
- You work from the keyboard and prefer a browser without Electron
- Cookie consent overlays need closing with Reject chosen
Not a fit when
- You need a browser for Windows or Linux: Octoweb works only on macOS
- You need headless running: this is a desktop application
- An agent must not be trusted with signing in and submitting forms in your browser profile
Example request
Open the pricing page in Octoweb, read the plan table text and briefly compare the three plansMCP
- Transport
- http
- Authentication
- not required
Limitations
macOS only: the prebuilt DMG is released for Apple Silicon, and a source build needs Rust and the Xcode Command Line Tools. The MCP server listens on `localhost:3434/mcp` inside the running browser, and the agent gets access to your tabs, including running JavaScript on pages and filling in forms. The installed app checks for updates once a day and installs them on quit, which can be turned off in settings. The last commit is dated November 11, 2026.
How to disable. Remove the `localhost:3434/mcp` entry in the MCP client settings and uninstall the app (`brew uninstall --cask octoweb` or drag `Octoweb.app` to the trash). Settings live in `~/Library/Application Support/octoweb`.
FAQ
What is the MCP server address?
`localhost:3434/mcp`, which runs inside a running Octoweb and uses HTTP JSON-RPC.
Which operations are available to the agent?
Navigation, a snapshot of interactive elements, reading page text, running JavaScript, click, typing, form filling, waiting, tabs, scrolling and hovering.
Does the agent take my focus?
No, navigation runs in the background. Only `browser_switch_tab` changes focus.
Which systems does Octoweb run on?
Only macOS, with a prebuilt app for Apple Silicon.
Are private tabs indexed?
No, private tabs never enter page memory.
Discussion
No questions or reviews yet.
Related
MCP serversAgent browser on direct CDP without Playwright: login profiles, a CLI, an MCP server and recording workflows into a skill
A developer browser on Chromium with a local MCP server: an agent lists tabs, reads the console, takes screenshots and clicks
A Rust browser engine without Chromium, with its own TLS fingerprint and V8; the MCP server gives agents pages and protection checks.
MCP server for Safari on macOS: an agent drives your real browser with your logins through 98 tools
A browser for agents and people with an MCP server: the agent works in tabs with your logins while you watch and can take over
A Rust MCP server that lets an agent control the desktop and the Chrome browser on your own computer
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Octoweb (this card) | no | not required | 144 | |
| Browser Use | no | 120,922 | a standalone macOS browser with a built-in MCP server and assistant | |
| BrowserTools MCP | no | not required | 7,342 | a full WebKit browser and not an extension for someone else browser |
README in short
The README presents Octoweb as a browser for thinking: keyboard control, a sidebar assistant and an MCP server for AI tools. It details features, the MCP tool list, shortcuts, installation, configuration and a section on what the browser is and is not.