claude-chrome

This MCP server enables Claude Desktop, Claude Code, and Cursor to interact with Claude.ai through a Chrome extension by acting as a WebSocket relay. The server runs locally and exposes a persistent WebSocket connection that coordinates browser-based commands and Claude.ai interactions. You can configure Claude Desktop to load this MCP server, after which you can issue natural language or scripted commands to manage Claude tabs, open new tabs, and send messages to Claude tabs via the extension. The server also provides async message sending with completion detection and forwards Claude-to-Claude responses, making it suitable for automated workflows and debugging.

Prerequisites:

• Google Chrome installed
• Node.js v16 or higher installed
• npm installed

Installation steps:

1. Install the Chrome extension:
   • Open Chrome and navigate to chrome://extensions/
   • Enable Developer mode
   • Click Load unpacked and select the extension/ directory from this project
2. Install server dependencies:
   • From the project root directory, run: cd mcp-server npm install
3. Configure Claude Desktop to load the MCP server:
   • In Claude Desktop, add a configuration with: { "mcpServers": { "claude-chrome-mcp": { "command": "node", "args": ["<absolute-path-to-project>/mcp-server/src/server.js"] } } }
   • Replace <absolute-path-to-project> with the full path to the project (e.g., /Users/you/claude-chrome-mcp)
4. Restart Claude Desktop to load the MCP server. The embedded WebSocket relay will start on port 54321 by default.
5. Test the connection by issuing commands within Claude Desktop, such as opening a new tab or sending messages to Claude tabs.

Tips and caveats:

• Ensure the Chrome extension is loaded from the correct directory (extension/).
• The MCP server exposes a WebSocket relay on port 54321; ensure this port is accessible from Claude Desktop.
• When configuring paths in Claude Desktop, use absolute paths to avoid environment-specific issues.
• If you encounter connection timeouts, verify Chrome extension permissions and that the relay process is running (check logs in the mcp-server directory).
• This setup supports async message sending and Claude-to-Claude forwarding, which is useful for multi-tab workflows and debugging scripts.