# OpenScreenShot

> OpenScreenShot is an open-source MCP server for browser automation. Capture website screenshots with local Chrome from a CLI or an AI agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Chrome extension, firefox-extension, API
- **Website:** https://openscreenshot.app
- **Repository:** https://github.com/pghqdev/openscreenshot/tree/HEAD/mcp
- **MCP Registry name:** io.github.PGHQdev/openscreenshot
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cloud.openscreenshot.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "openscreenshot": {
      "url": "https://cloud.openscreenshot.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/openscreenshot
