Skip to content
MCP server

OpenScreenShot

Capture website screenshots with local Chrome from a CLI or an AI agent

Pricing
Open source
Platforms
CLI, Chrome extension, firefox-extension
Runs
Locally or Remotely
Version
2.5.2
Listing updated
2 days ago

About OpenScreenShot

OpenScreenShot is an open-source MCP server for browser automation. It can run locally on your machine or as a hosted remote server.

The npm package drives a Chrome, Chromium or Edge already on your machine, so it ships no browser of its own. Run through npx, it saves a viewport or full-page PNG, and openscreenshot serve starts a local MCP server exposing a capture_screenshot tool to clients that support local servers.

The CLI lets you set viewport width and height, write to a file or stdout, and redact content by CSS selector, text pattern (email, phone, secret) or pixel rectangle. An optional OpenScreenShot Cloud renders remotely using an API key, adding formats such as JPEG, WebP, PDF, HTML and markdown, and a remote MCP endpoint exists for that mode.

It needs Node.js 22.12 or newer. Local use needs no account or key. The same project also publishes a browser extension for Chrome and Firefox that captures, annotates and exports pages on-device under an MIT licence.

Install

Run in a terminal

claude mcp add --transport http openscreenshot https://cloud.openscreenshot.app/mcp

Add to Settings → Connectors → Add custom connector

https://cloud.openscreenshot.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openscreenshot": {
      "url": "https://cloud.openscreenshot.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "openscreenshot": {
      "type": "http",
      "url": "https://cloud.openscreenshot.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openscreenshot": {
      "serverUrl": "https://cloud.openscreenshot.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openscreenshot": {
      "type": "http",
      "url": "https://cloud.openscreenshot.app/mcp"
    }
  }
}

Configuration

  • CHROME_PATHPath to a Chrome, Chromium, or Edge executable. Leave unset to auto-detect.
  • OPENSCREENSHOT_API_KEYAPI key for OpenScreenShot Cloud, used with cloud: true. Not needed for local captures.
  • OPENSCREENSHOT_CLOUD_URLOpenScreenShot Cloud base URL for cloud: true. Defaults to https://cloud.openscreenshot.app.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

capture_screenshot
Captures a website screenshot, viewport or full page, with local Chrome or on OpenScreenShot Cloud.

What it does

Local capture
Uses your installed Chrome, Chromium or Edge to take viewport or full-page shots.
Redaction options
Cover elements by selector, text patterns or fixed rectangles before saving.
Optional cloud rendering
Render on OpenScreenShot Cloud with an API key for more output formats.
CLI and MCP in one
The same package serves terminal, CI and agent use.
Adjustable viewport
Width from 200 to 3840 and height from 200 to 2160 pixels.

Good for

  • Screenshot a page in a CI step
  • Let an agent check how a deployed page looks
  • Mask emails and secrets before sharing a capture
  • Save full-page captures as PDF through the cloud option

Pricing

Open source

Free and MIT licensed; cloud rendering needs an API key and its prices are not published

Prices change. Check openscreenshot.app before you buy.

OpenScreenShot FAQ

Do I need an API key?

Not for local captures. A key is only used with the optional cloud mode.

What does it require?

Node.js 22.12 or newer and Chrome, Chromium or Edge.

Which licence?

The project site lists MIT.

What formats can I get?

PNG locally; with the cloud option PNG, JPEG, WebP, PDF, HTML or markdown.

Is OpenScreenShot free?

Yes. OpenScreenShot is open source, so you can use and self-host it for free.

How do I add OpenScreenShot to Claude Code?

Run this command in your terminal: claude mcp add --transport http openscreenshot https://cloud.openscreenshot.app/mcp

What are the best alternatives to OpenScreenShot?

The closest alternatives to OpenScreenShot are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

Alternatives to OpenScreenShot

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools