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