Skip to content
MCP server

PhotoFresco

Let AI agents edit images in a PhotoFresco window you approve, with undoable history

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
Web, macOS, CLI
Runs
Locally
Version
0.1.2
Listing updated
3 days ago

About PhotoFresco

PhotoFresco is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.

An agent steers a PhotoFresco editor window on your own computer, and you can watch each change, grant the connection, choose what it may do, and pause or stop it. Because edits go through the editor's own commands, every step lands in History and can be undone like your own.

The repository ships an MCP server (one tool per editor operation, previews returned as images, exports as files or resources), an Agent Skill that teaches good use, a command line for opening, running saved workflows and exporting, and the connector library they share. It needs Node.js 22 or newer and a Chromium-based browser at version 120 or later; macOS is verified, Windows and Linux are implemented but not yet verified.

File access is opt-in: --read and --write folders decide where the agent can open and save files. PhotoFresco itself is a browser editor with layers, masks, brushes, PSD import and export, and AI image generation; its pricing is a free core with ad-free from $8 a month and credit packs from $9.

Install

Run in a terminal

claude mcp add photofresco -- npx -y photofresco

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "photofresco": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "photofresco"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "photofresco": {
      "command": "npx",
      "args": [
        "-y",
        "photofresco"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "photofresco": {
      "command": "npx",
      "args": [
        "-y",
        "photofresco"
      ]
    }
  }
}

Configuration

  • PHOTOFRESCO_BROWSERPath to a Chromium-based browser (Chrome, Edge, Chromium) when none is installed in the standard location
  • PHOTOFRESCO_BROWSERPath to a Chromium-based browser (Chrome, Edge, Chromium) when none is installed in the standard location

What it does

Approved window
You allow the connection and can pause or stop the agent.
One tool per operation
Every editor action is exposed as an MCP tool.
Preview images
Agents get rendered previews to check their work.
Folder permissions
--read and --write limit where files can be opened and saved.
Agent skill and CLI
Includes a skill and command line for saved workflows.
Undoable history
Agent edits appear in History like manual edits.

Good for

  • Have an agent build a layered design step by step
  • Rough in an edit with an agent and finish by hand
  • Run a saved export workflow from the command line
  • Review exactly what an agent changed before accepting it

Pricing

Freemium, from $8 a month

Free editor; ad-free from $8/mo; AI credit packs from $9 one-time

Prices change. Check photofresco.com before you buy.

PhotoFresco FAQ

What do I need installed?

Node.js 22 or newer and Chrome, Edge or Chromium 120+.

Can the agent touch my files?

Only in folders you grant with --read and --write.

Which clients work?

Claude, Cursor, VS Code, Codex or any MCP client, plus one-click buttons for Cursor, VS Code and LM Studio.

What does PhotoFresco cost?

The editor is free; ad-free is from $8/month and AI credit packs from $9.

Is PhotoFresco free?

PhotoFresco has a free plan, with paid plans for more usage or features. Paid plans start at $8 a month.

How do I add PhotoFresco to Claude Code?

Run this command in your terminal: claude mcp add photofresco -- npx -y photofresco

What are the best alternatives to PhotoFresco?

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

Alternatives to PhotoFresco

  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. ChartAnt

    MCP server

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

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. 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
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media