Skip to content
MCP server

Harie

Edit screenshot annotations in place: boxes, callouts and masking kept in the image

Runs locallyStatus and history
Pricing
Open source
Platforms
Web, Chrome extension, CLI
Runs
Locally
Version
0.9.1
Listing updated
3 days ago

About Harie

Harie is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "harie": {
      "command": "npx",
      "args": [
        "-y",
        "@harie/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "harie": {
      "command": "npx",
      "args": [
        "-y",
        "@harie/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (7)

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

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.

What it does

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

Pricing

Open source

Free and open source (MIT)

Prices change. Check harie.studio before you buy.

Harie 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 to Harie

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media