What is Mcp Browser Tabs

mcp-browser-tabs is a Model Context Protocol server designed to retrieve and manage information about currently open Chrome browser tabs. It allows clients like Claude Desktop to fetch and control these tabs effectively.

Use cases

Use cases include automating the retrieval of tab information for reporting, managing multiple tabs during research, and creating custom workflows that involve opening or closing tabs based on user actions.

How to use

To use mcp-browser-tabs with Claude Desktop, add the specified configuration to your Claude Desktop settings. Ensure that Google Chrome has accessibility enabled for proper interaction with the tabs.

Key features

Key features include retrieving all open tabs with their titles and URLs, grouping tabs by window, and the ability to close specific tabs using window and tab indices.

Where to use

mcp-browser-tabs can be used in environments where Chrome browser tab management is necessary, such as software development, automation tasks, and enhancing user productivity.

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

1. 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