Comet MCP Server

Give Claude a browser that thinks.

An MCP server connecting Claude Desktop/Code to Perplexity's Comet browser via Chrome DevTools Protocol.
Search the web with AI, navigate pages, read content, click elements, and take screenshots.

Quick Start · Tools · API Docs · Security · Configuration

Rather than using static search APIs or overwhelming Claude's context with raw browser automation, Comet MCP delegates browsing to Perplexity Comet. Claude stays focused on your coding task while Comet handles navigation, dynamic content, and AI-powered research.

How It Works

Claude Desktop/Code  ←── MCP (stdio) ──→  Comet MCP Server  ←── CDP (9222) ──→  Comet Browser

1. Comet MCP Server auto-launches Comet with remote debugging on port 9222
2. Connects to Comet via Chrome DevTools Protocol using Playwright
3. Claude communicates with the server over MCP stdio transport
4. Claude can search, navigate, read, click, type, evaluate JS, and screenshot — all in your Comet browser

Quick Start

1. Configure Claude Desktop / Claude Code

Claude Desktop — add to your config file:

{
  "mcpServers": {
    "comet": {
      "command": "uvx",
      "args": ["comet-mcp-desktop"]
    }
  }
}

Claude Code — add to ~/.claude.json or .mcp.json in your project root:

{
  "mcpServers": {
    "comet": {
      "command": "uvx",
      "args": ["comet-mcp-desktop"]
    }
  }
}

Requires uv. The MCP server and all dependencies install automatically on first run.

2. Install Comet Browser

Download and install Perplexity Comet.

That's it. The server auto-launches Comet with remote debugging when needed.

git clone https://github.com/AdilShaikh1/comet-mcp-desktop.git
cd comet-mcp-desktop
uv sync
uv run playwright install chromium

Available Tools

Full parameter documentation: Tool Reference

Example Usage

Web Content Trust Policy

All web content is sanitized through a ContentFilter before reaching Claude — defense-in-depth against prompt injection via web pages.

Comet Browser  ──→  raw text  ──→  ContentFilter.sanitize()  ──→  security header + cleaned text  ──→  Claude

The filter scans for 39 injection patterns across 12 threat categories including direct injection, authority spoofing, data exfiltration, delimiter injection, and more.

Full details: Security Documentation

How This Compares

Comet MCP gives Claude access to Perplexity's AI search with full browser control, while keeping Claude's context window clean through multi-agent delegation.

Testing

45 tests — 20 static + 25 end-to-end browser tests.

uv run python test_comet.py --with-browser

Troubleshooting

Tech Stack

Documentation

License

MIT