browser-automation

Chrome Tabs▌

by kazuph

Chrome Tabs lets you manage and retrieve tab information from Chrome on macOS using AppleScript for seamless browser con

Integrates with Chrome on macOS to retrieve and manage browser tab information using AppleScript.

github stars

★ 11

GitHub npm

macOS onlyRequires Chrome accessibility permissionsStable tab IDs prevent accidental closures

best for

/ macOS users wanting to automate Chrome tab management
/ Organizing and cleaning up browser sessions
/ Building Chrome workflow automation tools

capabilities

/ Get all open Chrome tabs with titles and URLs
/ Close specific tabs using stable unique IDs
/ Activate and focus specific tabs
/ Manage tabs across multiple Chrome windows

what it does

Integrates with Chrome on macOS to view and manage browser tabs through AppleScript automation. Requires accessibility permissions to control Chrome tabs.

about

Chrome Tabs is a community-built MCP server published by kazuph that provides AI assistants with tools and capabilities via the Model Context Protocol. Chrome Tabs lets you manage and retrieve tab information from Chrome on macOS using AppleScript for seamless browser con It is categorized under browser automation. This server exposes 4 tools that AI clients can invoke during conversations and coding sessions.

how to install

You can install Chrome Tabs in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Chrome Tabs is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

MCP Browser Tabs

Model Context Protocol server for retrieving and managing Chrome browser tabs information. This allows Claude Desktop (or any MCP client) to fetch information about and control currently open Chrome tabs.

Quick Start (For Users)

To use this tool with Claude Desktop, simply add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "tools": {
    "browser-tabs": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-browser-tabs"]
    }
  }
}

This will automatically download and run the latest version of the tool when needed.

Required Setup

Enable Accessibility for Chrome:
- Open System Settings
- Go to Privacy & Security > Accessibility
- Click the "+" button
- Add Google Chrome from your Applications folder
- Turn ON the toggle for Chrome

This accessibility setting is required for AppleScript to interact with Chrome tabs.

For Developers

The following sections are for those who want to develop or modify the tool.

Prerequisites

Node.js 18+
macOS (for AppleScript operations)
Google Chrome
Claude Desktop (install from https://claude.ai/desktop)
tsx (install via npm install -g tsx)

Installation

git clone https://github.com/kazuph/mcp-browser-tabs.git
cd mcp-browser-tabs
npm install
npm run build

Available Tools

get_tabs: Retrieves all open tabs from Google Chrome browser, returning their titles and URLs. Tabs are grouped by window and displayed in a format like "Window 1-1" (Window 1, Tab 1).
close_tab: Closes a specific tab in Google Chrome using window and tab indices.
- Parameters:
  - windowIndex: Window number (starts from 1)
  - tabIndex: Tab number within the window (starts from 1)
- Note: When closing multiple tabs, start from the highest index numbers to avoid index shifting. After closing tabs, use get_tabs to confirm the changes.

Notes

This tool is designed for macOS only due to its dependency on AppleScript.
Requires Google Chrome to be installed and running.
Accessibility permissions must be granted for Chrome.

License

MIT License - see the LICENSE file for details