Arc Browser MCP
Arc Browser MCP lets MCP clients inspect Arc’s local Spaces, tabs, and history and perform explicit Arc browser actions on macOS.
Read a compact Arc overview with Space/tab counts, duplicates, missing URLs, source health, and live context.
Query, filter, and search tabs by query, Space, location, folder, domain, missing URL, or duplicate key.
Get full tab details, recovery candidates, and the Space/pinned/unpinned/folder sidebar hierarchy.
Search local Chromium history across Arc profiles.
Analyze tabs for duplicates, missing URLs, stale tabs, junk candidates, and recovery options.
Create a tab in an explicit Space and receive its verified tab ID.
Focus Spaces, select tabs, navigate/open URLs in a specific or active tab, and reload tabs.
Close tabs by explicit IDs, with
dry_runpreview support; this is destructive.Execute JavaScript in a tab only when
ARC_MCP_ENABLE_JAVASCRIPT=1is set.Note: the project is archived and will stop working when Arc sunsets on December 22, 2026.
Provides tools for inspecting and controlling Arc Browser spaces, tabs, and history on macOS, including reading sidebar data, creating/navigating/closing tabs, focusing spaces, and optionally executing JavaScript in tabs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Arc Browser MCP list tabs in my Research space"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Arc Browser MCP
This project is archived and no longer maintained. The Browser Company is ending Arc on December 22, 2026. After that date Arc stops working on macOS and Windows and Arc accounts are deactivated (announcement coverage). This server depends on Arc, so it will stop working then. The code stays here for reference.
Arc Browser MCP is a local stdio MCP server for inspecting and controlling Arc Browser Spaces and tabs on macOS.
It gives MCP clients such as Codex, Claude Code, opencode, and Claude Desktop a structured way to read Arc's local sidebar/history data and perform explicit Arc actions like focusing Spaces, selecting tabs, creating tabs, navigating tabs, reloading tabs, closing tabs, and optionally executing JavaScript.
Why This Exists
I built this because my Arc setup had become a very specific kind of personal knowledge system: lots of tabs, spread across lots of Spaces, quietly standing in for bookmarks, reading lists, project context, and things I was definitely going to deal with later.
That works until it does not. Once the browser becomes both workspace and storage, it gets hard to tell what is still useful, what is duplicated, what belongs in a second brain, and what can finally be closed. Arc Browser MCP makes that state legible to local agents so they can help inspect, search, organize, summarize, save, and clean up tabs with explicit user-controlled actions.
Arc automation is useful for focused browser actions, but it is not the best source for a complete, background-safe inventory of Spaces, folders, pinned and unpinned tabs, and history. In local testing with my Arc profile, reading all tabs through Arc automation could take up to 30 seconds; reading the same state from Arc's local JSON files took less than 10 ms, over 3,000x faster. Mutations use Arc automation because those changes take effect immediately without requiring a browser restart.
Related MCP server: supasidebar-mcp
Tools
The server exposes compact v2 tools grouped by behavior. Read tools inspect local Arc data and do not intentionally change visible browser state. Create, edit, and delete tools automate Arc and can change what is visible in the browser.
Read Tools
Tool | Description |
| Returns a compact inventory of Arc Spaces, tab counts, pinned/unpinned counts, folder counts, missing URL counts, duplicate counts, and source warnings. |
| Lists, filters, and searches active Arc tabs using the local Arc index. Supports |
| Returns a full normalized tab record for an explicit |
| Returns the Space, pinned, unpinned, and folder hierarchy. Set |
| Searches local Arc Chromium history snapshots across profiles. Supports |
| Analyzes tabs for |
Create Tools
Tool | Description |
| Creates a new tab in an explicit Arc Space. Requires |
Edit And Navigation Tools
Tool | Description |
| Focuses an Arc Space by explicit |
| Selects an Arc tab by explicit |
| Navigates a specific tab when |
| Reloads one or more tabs by explicit |
| Executes JavaScript in an explicit tab. Disabled by default and available only when |
Delete Tools
Tool | Description |
| Closes one or more tabs by explicit |
Find duplicate tabs:
{
"analyses": ["duplicates"],
"limit": 25,
"include_evidence": true
}Search tabs in a Space:
{
"query": "docs",
"space_id": "space-id",
"limit": 20
}Create a tab in a known Space:
{
"space_id": "space-id",
"url": "https://example.com",
"select": true
}Preview closing tabs:
{
"tab_ids": ["tab-id-1", "tab-id-2"],
"dry_run": true
}Close tabs after review:
{
"tab_ids": ["tab-id-1", "tab-id-2"],
"dry_run": false
}Quick Start
Requirements:
macOS
Arc installed at
/Applications/Arc.appPython 3.12 or newer
uv/uvxA local stdio MCP client
macOS Automation permission for the MCP client or terminal app when using mutating tools
Run the server directly:
uvx arc-browser-mcpRun a local prerequisite check:
uvx arc-browser-mcp doctorInstallation
codex mcp add arc-browser -- uvx arc-browser-mcpclaude mcp add --transport stdio --scope user arc-browser -- uvx arc-browser-mcpAdd this server entry to ~/.config/opencode/opencode.json or a project
opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"arc_browser": {
"type": "local",
"command": ["uvx", "arc-browser-mcp"],
"enabled": true,
"timeout": 10000
}
}
}For local development, add this to the Claude Desktop MCP config:
{
"mcpServers": {
"arc-browser": {
"command": "uvx",
"args": ["arc-browser-mcp"],
"env": {}
}
}
}For end users, prefer a Claude Desktop Extension / DXT package. This repository includes MCPB packaging metadata for that workflow:
npm install -g @anthropic-ai/mcpb
mcpb packFrom a checkout of this repository:
uv sync
uv run arc-browser-mcp doctor
uv run arc-browser-mcp serveFor a local MCP client config that runs from source, use:
uv run arc-browser-mcpor:
uv run arc-browser-mcp serveYou can also print client-specific install guidance:
uvx arc-browser-mcp install --client codex
uvx arc-browser-mcp install --client claude-code
uvx arc-browser-mcp install --client opencode
uvx arc-browser-mcp install --client claude-desktopSafety And Privacy
The server is local and communicates with MCP clients over stdio.
Read tools may return private browser data to the connected MCP client, including titles, URLs, domains, Space names, folder names, profile IDs, history metadata, and local source paths.
The server does not send browser data anywhere by itself. Your MCP client and its model provider receive whatever data they request through tool calls.
Mutating tools change visible Arc state, including focused Spaces, selected tabs, newly created tabs, opened URLs, reloaded tabs, and closed tabs.
Destructive actions require explicit tab IDs.
arc_close_tabsalso supportsdry_run.arc_create_tabrequires an explicit Space ID and verifies the created tab before returning its ID.arc_execute_javascriptis disabled unlessARC_MCP_ENABLE_JAVASCRIPT=1is set in the MCP server environment.The server does not directly edit Arc sidebar, archive, command ranking, or history files. Changes go through Arc automation instead.
Reference
Less common setup, debugging, and development details live here.
arc-browser-mcp serve
arc-browser-mcp doctor
arc-browser-mcp smoke --read-only
arc-browser-mcp install --client codex
arc-browser-mcp install --client claude-code
arc-browser-mcp install --client opencode
arc-browser-mcp install --client claude-desktopserve runs the MCP server over stdio. Running arc-browser-mcp without a
subcommand also starts the server.
doctor checks macOS, osascript, uvx, and the expected Arc app location.
smoke --read-only runs live read-only checks against local Arc state. It does
not call mutating tools.
install --client ... prints MCP configuration guidance for a supported client.
Arc Is Not Running
Mutating tools and live Arc reads through AppleScript/JXA require Arc to be running. Open Arc and retry the tool call.
macOS Automation Permission Is Denied
If Arc actions fail with an automation or permissions error, open macOS System Settings and check the Automation and Privacy & Security permissions for the terminal or MCP client that launches this server.
uvx Is Missing
Install uv from the official installer or package manager you use, then rerun:
arc-browser-mcp doctorJavaScript Execution Is Disabled
arc_execute_javascript intentionally fails unless enabled:
ARC_MCP_ENABLE_JAVASCRIPT=1 uvx arc-browser-mcpOnly enable this in a client configuration where you are comfortable allowing explicit JavaScript execution in browser tabs.
Multiple Arc Windows
Some tools accept window_id. Use arc_get_overview, arc_query_tabs, or a
client-visible tab record to identify Space and tab IDs first. When creating a
tab and more than one Arc window is open, pass window_id when you need the tab
created in a specific window.
Set up the local environment:
uv syncRun tests and linting:
uv run pytest
uv run ruff check .Run local checks against Arc:
uv run arc-browser-mcp doctor
uv run arc-browser-mcp smoke --read-onlyRun the server from source:
uv run arc-browser-mcp serveManual live verification steps are documented in
docs/manual-verification.md.
The repository includes manifest.json and .mcpbignore for MCPB packaging:
npm install -g @anthropic-ai/mcpb
mcpb packLicense
MIT. See LICENSE.
Available Tools
13 toolsarc_analyze_tabsARead-onlyIdempotent
Analyze Arc tabs for duplicates, stale tabs, junk candidates, and missing URLs.
Inputs: analyses (required), limit, include_evidence, stale_before. Returns: object
arc_close_tabsADestructive
Close one or more Arc tabs by explicit tab id. Use dry_run to preview.
Inputs: tab_ids (required), dry_run. Returns: object
arc_create_tabC
Create a new Arc tab in an explicit Space and return its verified tab id.
Inputs: space_id (required), url (required), window_id, select. Returns: object
arc_execute_javascriptB
Execute JavaScript in an Arc tab. Disabled unless ARC_MCP_ENABLE_JAVASCRIPT=1.
Inputs: tab_id (required), javascript (required). Returns: object
arc_focus_spaceB
Focus an Arc Space by explicit id. This changes visible Arc state.
Inputs: space_id (required). Returns: object
arc_get_overviewARead-onlyIdempotent
Get compact Arc inventory, counts, source health, and live context when available.
Inputs: no named parameters. Returns: object
arc_get_sidebar_treeARead-onlyIdempotent
Get Arc Space, pinned, unpinned, and folder hierarchy.
Inputs: space_id, include_tabs. Returns: object
arc_get_tabARead-onlyIdempotent
Get a full normalized Arc tab record by explicit tab id.
Inputs: tab_id (required), include_recovery. Returns: object
arc_open_urlB
Navigate a specific Arc tab, or the active tab when explicitly omitted.
Inputs: url (required), tab_id. Returns: object
arc_query_tabsBRead-onlyIdempotent
List, filter, and search Arc tabs using the fast local Arc index.
Inputs: query, space_id, location, folder_id, +5 more. Returns: object
arc_reload_tabsA
Reload one or more Arc tabs by explicit tab id.
Inputs: tab_ids (required). Returns: object
arc_search_historyCRead-onlyIdempotent
Search Arc Chromium history snapshots across local profiles.
Inputs: query, domain, profile_id, include_hidden, +2 more. Returns: object
arc_select_tabB
Select an Arc tab by explicit id. This changes visible Arc state.
Inputs: tab_id (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct operation: analyze, close, create, execute JS, focus space, get overview, get sidebar tree, get tab, open URL, query tabs, reload tabs, search history, select tab. No overlapping purposes; an agent can clearly differentiate based on names and descriptions.
All tools follow the consistent pattern `arc_verb_noun` with snake_case. Verbs are appropriately chosen (e.g., create, close, query, select) and nouns match the resource (tab, tabs, space, url). Singular/plural variations are logically applied.
13 tools is well-scoped for a browser automation server. Each tool serves a clear purpose without redundancy, covering tab lifecycle, space navigation, and basic utility like history search and JavaScript execution.
The tool set covers core tab and space operations (CRUD, navigation, analysis, history). Missing features like bookmark management or space creation are minor gaps, but the surface is sufficient for typical automation tasks.
Maintenance
Related MCP Connectors
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Control your Chrome from chat: open websites, read what's on the page, click buttons, and fill in f…
Let AI agents observe and control Chrome tabs you explicitly share via Browse Bridge.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for the Arc browser that enables programmatic management of spaces and tabs. It supports actions like listing, creating, and deleting spaces and tabs, as well as focusing spaces and opening URLs via AppleScript.98MIT
- AlicenseAqualityCmaintenanceAccess and organize your open browser tabs, bookmarks, and recently visited links across every macOS browser from your AI client. Powered by the free tier of SupaSidebar(https://supasidebar.com) app.367MIT
- AlicenseAqualityDmaintenanceEnables macOS system automation, window management, and productivity tools for AI agents, including running AppleScripts, opening apps, retrieving browser tabs, taking screenshots, and controlling system settings.21MIT
- AlicenseAqualityBmaintenanceEnables AI agents to drive the Arc browser on macOS, including tab management, navigation, page reading, DOM interaction, and JavaScript scripting via AppleScript automation.5033 npm2MIT