arc-mcp

MCP (Model Context Protocol) server for Arc browser. Manage spaces and tabs programmatically.

Features

List spaces - Get all Arc browser spaces
Create space - Create new spaces with custom names and icons
Delete space - Remove spaces
Focus space - Switch to a specific space (AppleScript)
List tabs - Get tabs from all spaces or a specific space
Add tab - Add tabs to spaces
Delete tab - Remove tabs
Open URL - Open URLs in Arc immediately (AppleScript)

Requirements

macOS (Arc browser is macOS-only)
Arc browser installed
Arc Sync must be disabled for space/tab modifications to persist

Installation

bun install

Usage

With Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "arc": {
      "command": "npx",
      "args": ["tsx", "/path/to/arc-mcp/src/index.ts"]
    }
  }
}

Running directly

bun start
# or
npx tsx src/index.ts

Tools

`list_spaces`

List all Arc browser spaces.

`create_space`

Create a new space.

Parameter	Type	Required	Description
name	string	Yes	Name of the new space
icon	string	No	Emoji or SF Symbol name (default: "star")

`delete_space`

Delete a space.

Parameter	Type	Required	Description
space	string	Yes	Name or ID of space to delete

`focus_space`

Switch to a space (uses AppleScript).

Parameter	Type	Required	Description
space	string	Yes	Name or ID of space to focus

`list_tabs`

List tabs, optionally filtered by space.

Parameter	Type	Required	Description
space	string	No	Name or ID of space to filter by

`add_tab`

Add a tab to a space. Requires Arc restart.

Parameter	Type	Required	Description
space	string	Yes	Name or ID of space
url	string	Yes	URL for the tab
title	string	No	Tab title (defaults to URL)
pinned	boolean	No	Add as pinned tab (default: false)

`delete_tab`

Delete a tab by ID. Requires Arc restart.

Parameter	Type	Required	Description
tabId	string	Yes	ID of tab to delete

`open_url`

Open a URL immediately in Arc (uses AppleScript).

Parameter	Type	Required	Description
url	string	Yes	URL to open
space	string	No	Space to open the URL in

Important Notes

Arc Sync: For space/tab modifications to persist, disable Arc Sync in Arc settings. Otherwise, the sync will overwrite local changes.
Restart Required: Most modifications (create/delete space, add/delete tab) require restarting Arc to take effect.
Backup: The server automatically creates backups before modifying Arc's sidebar data.

How It Works

Arc stores its sidebar data in ~/Library/Application Support/Arc/StorableSidebar.json. This MCP server reads and modifies that file directly for space and tab management.

For immediate actions (focus space, open URL), it uses AppleScript to control Arc.

License

MIT