Skip to main content
Glama
Sign In
arc-mcp

arc-mcp

by happylinks
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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)

Related MCP server: macos-mcp

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

Available Tools

9 tools
add_tabA

Add a new tab to an Arc browser space. Requires Arc restart to see in sidebar. For immediate opening, use open_url instead.

Inputs: space (required), url (required), title, pinned.

create_spaceA

Create a new Arc browser space. Requires Arc restart to take effect. Note: Arc sync must be disabled for changes to persist.

Inputs: name (required), icon.

create_workspaceA

Create a new workspace (space + tabs) in one command. Useful for setting up a focused context for a ticket or task. Requires Arc restart.

Inputs: name (required), urls (required), icon.

delete_spaceA

Delete an Arc browser space by name or ID. Requires Arc restart to take effect.

Inputs: space (required).

delete_tabA

Delete a tab from Arc browser by its ID. Requires Arc restart to take effect.

Inputs: tabId (required).

focus_spaceB

Switch to a specific Arc browser space (uses AppleScript)

Inputs: space (required).

list_spacesB

List all Arc browser spaces

Inputs: no named parameters.

list_tabsA

List tabs and folders in an Arc browser space with full hierarchy. Shows pinned and unpinned sections with nested folders.

Inputs: space.

open_urlA

Open a URL in Arc browser immediately (uses AppleScript). Optionally specify a space.

Inputs: url (required), space.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have distinct purposes, but 'create_space' and 'create_workspace' could be confused as both create spaces, though the latter includes tabs. Descriptions clarify that 'create_workspace' is for setting up a focused context, which helps differentiate it.

    Naming Consistency5/5

    All tools follow a consistent verb_noun naming pattern (e.g., add_tab, create_space, list_spaces). The naming is uniform and predictable, making it easy to understand each tool's function at a glance.

    Tool Count5/5

    With 9 tools, the server is well-scoped for managing Arc browser spaces and tabs. Each tool serves a clear purpose, covering core operations like creation, deletion, listing, and navigation without being overwhelming.

    Completeness4/5

    The toolset provides good coverage for space and tab management, including CRUD operations for spaces and tabs, and navigation tools. A minor gap is the lack of update operations for spaces or tabs, but agents can work around this by deleting and recreating as needed.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Arc Browser MCP

      jasoncronje
      A
      license
      A
      quality
      F
      maintenance
      Enables inspection and control of Arc Browser spaces and tabs on macOS, including reading sidebar/history data and performing actions like focusing spaces, creating and closing tabs.
      13
      18 PyPI
      1
      MIT

    • macos-mcp

      CursorTouch
      A
      license
      Not graded
      quality
      A
      maintenance
      A lightweight MCP server that bridges AI agents and macOS, enabling automation of file navigation, application control, UI interaction, browser automation, and system operations.
      239
      MIT

    • arc-lite-mcp

      yzanbo
      A
      license
      A
      quality
      D
      maintenance
      A lightweight MCP server to control Arc Browser on macOS, optimized for frontend development with 30 tools including DOM operations, debugging, and network monitoring.
      30
      MIT