MCP Browser Tabs Server

by kazuph
MIT License
14
2
  • Apple

Integrations

  • Allows retrieving information about and controlling currently open Chrome tabs, including listing all open tabs with their titles and URLs, and closing specific tabs by window and tab indices.

  • Designed specifically for macOS due to its dependency on AppleScript for interacting with Chrome tabs.

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables interaction with Google Chrome tabs through the MCP protocol, allowing clients to retrieve information and control tabs on macOS using AppleScript.

  1. Quick Start (For Users)
    1. Required Setup
  2. For Developers
    1. Prerequisites
    2. Installation
  3. Available Tools
    1. Notes
      1. License

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          Enables Google search and webpage content extraction via Chrome for macOS, allowing access to both unauthenticated and authenticated content, and integrates with Claude for secure and automated browsing tasks.
          Last updated -
          2
          45
          7
          MIT License
          • Apple
        • A
          security
          A
          license
          A
          quality
          An MCP server that provides tools for interacting with Chrome through its DevTools Protocol, enabling remote control of Chrome tabs to execute JavaScript, capture screenshots, monitor network traffic, and more.
          Last updated -
          7
          30
          14
          TypeScript
          MIT License
          • Linux
          • Apple
        • A
          security
          F
          license
          A
          quality
          Controls Chrome browser with debugging capabilities, allowing page automation, extension management, and userscript injection through the Model Context Protocol.
          Last updated -
          13
          13
          JavaScript
          • Linux
          • Apple
        • -
          security
          -
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants to control Chrome browsers through the Chrome DevTools Protocol, allowing for navigation, clicking, typing, and extracting page information.
          Last updated -
          3
          TypeScript

        View all related MCP servers

        ID: wze1kc6emp