gimp-mcp: enabling AI-driven image editing with live feedback via Model Context Protocol

GIMP MCP turns GIMP 3.2 from a traditional image editing tool into an AI-assisted platform where natural language commands control complex editing workflows. The key innovation is its get_state_snapshot function, which returns live PNG previews mid-workflow, allowing AI agents like Claude and Gemini to visually verify each editing step and autonomously refine their commands. This feedback loop elevates GIMP automation beyond blind scripting to a partnership with AI agents that can see their effects in real time.

a Model Context Protocol server bridging GIMP with AI assistants

At its core, gimp-mcp is a Python server implementing the Model Context Protocol (MCP) to expose GIMP 3.2’s professional image editing engine to AI clients. It wraps GIMP’s functionality into 56 dedicated tool commands, covering adjustments, transforms, selections, layers, drawing, text, and filters. These commands are accessible through natural language instructions sent from MCP-compatible clients such as Claude Desktop, Claude Code, Gemini CLI, and PydanticAI.

The architecture involves running a Python MCP server inside GIMP as a plugin. This server listens on localhost (port 9877 by default) and translates MCP tool calls into GIMP operations. The plugin is lightweight and communicates with the AI client via the MCP protocol, which standardizes command requests and responses.

A standout architectural feature is the get_state_snapshot tool. It produces live PNG previews of the current image state mid-pipeline without saving to disk. This snapshot enables AI agents to visually inspect each step’s output, verify correctness, and iteratively issue refined commands. This visual feedback loop supports fully autonomous multi-step pipelines: open, edit, verify, refine, export.

The repo supports 56 tool commands, all tested to pass (56/56 tests), ensuring reliability. It targets GIMP 3.2.x, verified on multiple platforms (Windows, macOS, Linux). Under the hood, the code is Python 3.8+ based, integrating tightly with GIMP’s Python API and MCP tooling.

technical strengths, tradeoffs, and code quality

What sets gimp-mcp apart is its seamless integration of AI-driven workflows with a visual feedback mechanism. The get_state_snapshot method is a technical highlight that enables agentic automation — AI agents don’t just issue commands blindly, they “see” the edits and iteratively improve them.

This approach contrasts with typical automation scripts that lack feedback and often require manual correction. Here, the AI can autonomously manage multi-step editing pipelines without intermediate manual intervention.

The codebase reflects solid engineering: 56 tool commands are fully covered by tests, indicating good attention to reliability and correctness. The plugin architecture leverages GIMP’s Python API effectively, while the MCP server standardizes communication so any MCP client can interact with GIMP.

The tradeoff is the complexity of setup and environmental requirements. It demands GIMP 3.2+, Python 3.8 or newer, and installation of the MCP server plugin into GIMP’s plugin directory, which varies across OSes. Users must also configure their MCP-compatible AI client to connect to the local MCP server properly.

Another limitation is the dependency on the MCP protocol and compatible AI clients. While several clients are supported, integrating with other AI systems may require adaptation.

Overall, the design balances power and flexibility with practical constraints around environment setup and client compatibility.

quick start: setting up gimp-mcp

1. install dependencies

git clone https://github.com/maorcc/gimp-mcp.git
cd gimp-mcp
uv sync

2. install the gimp plugin

Copy gimp-mcp-plugin.py to GIMP’s plug-ins directory and restart GIMP.

Linux (standard):

mkdir -p ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin
cp gimp-mcp-plugin.py ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/
chmod +x ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/gimp-mcp-plugin.py

Linux (Snap):

mkdir -p ~/snap/gimp/current/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin
cp gimp-mcp-plugin.py ~/snap/gimp/current/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/
chmod +x ~/snap/gimp/current/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/gimp-mcp-plugin.py

macOS:

mkdir -p ~/Library/Application\ Support/GIMP/3.0/plug-ins/gimp-mcp-plugin
cp gimp-mcp-plugin.py ~/Library/Application\ Support/GIMP/3.0/plug-ins/gimp-mcp-plugin/
chmod +x ~/Library/Application\ Support/GIMP/3.0/plug-ins/gimp-mcp-plugin/gimp-mcp-plugin.py

Windows:

%APPDATA%\GIMP\3.2\plug-ins\gimp-mcp-plugin\gimp-mcp-plugin.py

No chmod needed on Windows. Just copy and restart GIMP.

3. start the mcp server in gimp

Open any image in GIMP
Go to Tools > Start MCP Server
Server starts on localhost:9877

4. configure your mcp client

Example for Claude Desktop (Linux/macOS ~/.config/Claude/claude_desktop_config.json or Windows %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "gimp": {
      "command": "uv",
      "args": ["run", "--directory", "/full/path/to/gimp-mcp", "gimp_mcp_server.py"]
    }
  }
}

This setup allows the AI client to communicate seamlessly with the GIMP MCP server.

verdict

GIMP MCP is a well-engineered bridge between professional image editing and AI-driven automation using the Model Context Protocol. Its unique ability to produce live image snapshots mid-pipeline enables AI agents to visually verify and refine edits autonomously, moving beyond blind scripting.

It’s particularly relevant for developers and researchers working on agentic AI workflows in creative domains, or those integrating natural language-driven image editing with GIMP 3.2. The code quality and test coverage inspire confidence, though the setup complexity and dependence on MCP-compatible clients may limit casual users.

If you’re exploring AI-powered automation in visual content creation and want a feedback-driven editing pipeline, gimp-mcp offers a solid foundation to build upon.

freecad-mcp: bridging AI and parametric CAD through an MCP server — freecad-mcp uses an MCP server to connect Claude Desktop AI with FreeCAD, enabling AI-driven parametric CAD modeling thr
Blueprint MCP: async AI diagram generation for code architecture visualization — Blueprint MCP is a Python MCP server that generates system diagrams from codebases asynchronously using Google’s Nano Ba
Exploring the Model Context Protocol with awesome-mcp-servers: a curated directory of MCP server implementations — awesome-mcp-servers is a curated list of Model Context Protocol (MCP) servers enabling AI models to interact securely wi
graymatter: a modular MCP server for local-first AI prompt packages — Graymatter is a Go-based MCP server managing modular prompt packages for AI agents like Claude Code, offering local-firs
Paper2Agent: Automating the transformation of research paper codebases into interactive MCP servers — Paper2Agent automates converting research paper codebases into interactive MCP servers for AI coding agents, handling tu

→ GitHub Repo: maorcc/gimp-mcp ⭐ 117 · Python

Noureddine RAMDI / gimp-mcp: enabling AI-driven image editing with live feedback via Model Context Protocol