home / mcp / comet mcp server

Comet MCP Server

Provides an MCP server that delegates web browsing to Perplexity Comet for Claude Code research and monitoring.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "simplicianokelly52-comet_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "comet-mcp"
      ],
      "env": {
        "COMET_PATH": "YOUR_PATH_TO_COMET_APP_OR_DIR"
      }
    }
  }
}

You have an MCP server that lets Claude Code delegate web browsing and research to Perplexity Comet. This separation keeps Claude focused on coding while Comet handles navigation, login walls, dynamic content, and in-depth research, giving you faster, more reliable results with isolated browser contexts.

How to use

You interact with the Comet MCP server through your MCP client. Start by connecting the Comet MCP to Claude Code, then perform tasks like researching topics, logging into services, or saving research to folders. Claude will issue high-level goals, and Comet will carry out the necessary browser actions while returning results to Claude.

How to install

Prerequisites you need before installation:

- Node.js 18+ is required.

- Perplexity Comet Browser should be installed.

Step 1: Install Comet Browser

Download: https://www.perplexity.ai/comet
```}],{

Step 2: Add to Claude Code configuration to enable MCP support.

Step 2: Add to Claude Code configuration to enable MCP support

{
  "mcpServers": {
    "comet": {
      "command": "npx",
      "args": ["-y", "comet-mcp"]
    }
  }
}
```}],{

Step 3: macOS setup to create an isolated MCP browser (one-time). Run the setup script to ensure Comet MCP runs in its own isolated context.

First Use

1. Restart Claude Code

2. Say: "Connect to Comet"

3. In the MCP window, login to Perplexity if prompted (first time only)

4. You’re ready to start researching with Comet and Claude Code working together

Try It

You: "Use Comet to research the top AI frameworks in 2025"

Claude: [delegates to Comet, monitors progress, returns results]

You: "Log into my GitHub and check my notifications"

Claude: [Comet handles the login flow and navigation]

You: "Save this research to my 'AI Projects' folder"

Notes on usage and capabilities

Comet MCP runs on port 9223, isolated from your personal browser, and uses a separate profile stored under ~/.comet-mcp. A visual [MCP] badge helps you distinguish the MCP browser window from other instances.

What you can do with the Tools

Comet MCP exposes several actions you can invoke from Claude Code, including connecting to the MCP, initiating tasks, polling progress, stopping tasks, taking screenshots, switching modes, and organizing research folders or the library.

Available tools

comet_connect

Connect to MCP-dedicated Comet (auto-starts, isolated from personal browser)

comet_ask

Send a task to Comet and wait for a response

comet_poll

Check progress on long-running tasks

comet_stop

Stop the current task

comet_screenshot

Capture a screenshot of the current page in Comet

comet_mode

Switch modes such as search, research, labs, or learn

comet_folders

List, create, or save research into folders

comet_library

Search your existing Perplexity research history