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

1. Arc Sync: For space/tab modifications to persist, disable Arc Sync in Arc settings. Otherwise, the sync will overwrite local changes.

2. Restart Required: Most modifications (create/delete space, add/delete tab) require restarting Arc to take effect.

3. 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