# Harie

> Harie is an open-source MCP server for design and media. Edit screenshot annotations in place: boxes, callouts and masking kept in the image. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, Chrome extension, CLI, self-hosted
- **Website:** https://harie.studio/en/
- **Repository:** https://github.com/hosshan/harie/tree/HEAD/apps/mcp
- **MCP Registry name:** io.github.hosshan/harie
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-14

## About

Harie stores annotations inside an ordinary JPEG or PNG, so a help-doc screenshot can be pasted anywhere yet reopened later with every box and caption editable. This server lets an assistant read and write those files locally; it never calls an LLM, because the client's model looks at the image and decides what to mark.

Annotation types are rect, ellipse, arrow, text, callout, badge, spotlight and blur. Tools open, create, preview, edit and list files, mask personal information by burning it into the base image (saved only with `confirm: true`), and replace the base screenshot while keeping annotations scaled to fit. A frame operation adds padding, shadow or rounded corners.

Harie is open source under MIT, with a browser editor in seven languages, a Chrome extension and AI-drafted numbered boxes.

## Features

- **Editable annotations:** Boxes, arrows, callouts, badges and spotlights live inside the image.
- **Local server:** Reads and writes files over stdio; no LLM calls.
- **Irreversible masking:** Burn dummy values over names and emails, with a confirm step.
- **Swap the base image:** Keep annotations when the UI screenshot changes.
- **Framing:** Add padding, shadow, border or rounded corners.

## Good for

- Update a help-center screenshot after a UI rename
- Number steps in a user guide
- Hide customer data before publishing
- Let an assistant place a box around a button

## Install

### Claude Code (Terminal)

```sh
claude mcp add harie -- npx -y @harie/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "harie": {
      "command": "npx",
      "args": [
        "-y",
        "@harie/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "harie": {
      "command": "npx",
      "args": [
        "-y",
        "@harie/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "harie": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@harie/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "harie": {
      "command": "npx",
      "args": [
        "-y",
        "@harie/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "harie": {
      "command": "npx",
      "args": [
        "-y",
        "@harie/mcp"
      ]
    }
  }
}
```

## Tools

- `harie_open`: Open a file and return its annotations and image.
- `harie_create`: Create a Harie file from a plain image.
- `harie_preview`: Preview annotation changes without saving.
- `harie_edit`: Apply annotation changes and overwrite the file.
- `harie_list`: List Harie files in a directory.
- `harie_mask`: Burn over personal information in the base image.
- `harie_replace_base`: Swap the image while keeping annotations.

## FAQ

### Is Harie open source?

Yes, under the MIT licence, with source on GitHub.

### Which file formats?

JPEG and PNG output; SVG, WebP, GIF and HEIC are converted on import.

### Does masking undo?

No, masking is irreversible once saved.

### Does the server use an AI model?

No. The connected client's model does the reasoning.

### Is Harie free?

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

### How do I add Harie to Claude Code?

Run this command in your terminal: claude mcp add harie -- npx -y @harie/mcp

### What are the best alternatives to Harie?

The closest alternatives to Harie are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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