Allows for programmatic management of the Arc browser, providing tools to list, create, delete, and focus spaces, as well as manage tabs and open URLs.
Click on "Install 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-mcplist all my open tabs in the Work 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-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 installUsage
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.tsTools
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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.