Arc

Provides an MCP interface to manage Arc browser spaces and tabs via direct data edits and AppleScript actions.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server lets you manage Arc browser spaces and tabs programmatically from your automation client. You can list, create, delete, and focus spaces, as well as list, add, and remove tabs, or open URLs directly in Arc. It’s designed to work on macOS where Arc runs and uses AppleScript for immediate actions.

How to use

You connect a client to this MCP server to perform space and tab management. The server exposes a set of tools you can call from your automation workflow, including listing and manipulating spaces and tabs, and opening URLs in Arc.

How to install

Prerequisites: ensure your macOS machine has Arc installed and Arc Sync disabled if you want changes to persist.

Install the MCP server dependencies and start the server using one of the following methods.

Option 1 — Running via bun (recommended):

bun install
bun start

Option 2 — Running directly with tsx (when you want to invoke the MCP source directly):

npx tsx src/index.ts

MCP server configuration and usage for clients

To connect a client to this MCP server, use the following configuration. This example shows how to configure a stdio MCP server entry that runs the server via npx tsx from a local path.

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

Available tools

list_spaces

Return the list of all Arc browser spaces.

create_space

Create a new space with a given name and optional icon.

delete_space

Delete a specified space by name or ID.

focus_space

Switch to a specific space using AppleScript integration.

list_tabs

List tabs, optionally filtered by a specific space.

add_tab

Add a tab to a specified space, optionally pinning it.

delete_tab

Delete a tab by its ID, requiring an Arc restart for the change to take effect.

open_url

Open a URL immediately in Arc using AppleScript.