Servers / gimp-agent-mcp

gimp-agent-mcp

The whole of GIMP 3 for AI agents: everyday edits, one undo step, pixel checks, and recipes. Tested on Windows, Linux and macOS.

PythonstdiobetaIn the official registry

Install in Claude Code

claude mcp add gimp -- uvx gimp-agent-mcp serve

For other stdio clients, use the process and arguments after --. Follow the source documentation for runtimes, credentials and application setup.

Owner-built project. Status is maintainer-reported; inclusion is not an independent audit. Version information may lag upstream releases. Listing standards · Read as Markdown

An MCP server that hands AI agents the whole of GIMP 3 rather than a hand-picked slice. Every one of GIMP's roughly 1,000 Procedure Database functions and 207 GEGL filters is reachable through runtime introspection, so nothing goes stale when GIMP updates. The agent can see its work: a PNG render after each step, before/after/diff comparisons, and pixel measurement instead of guessing. Recipes turn repeatable jobs (stickers, icon sets, watermarks, contact sheets, social cards from a layout manifest) into one call, and a batch runner applies them to whole folders. Version 0.5.0 groups a batch of edits into one undo step and is exercised against real GIMP on Windows, Linux and macOS.

Review and maturity

Metadata review ·

Package and release documentation checked at 0.5.0. Cross-platform GIMP checks are recorded upstream; this review did not repeat visible-window or fresh-install tests.

What the status labels mean

What it does

  • Tools, reusable recipes and bundled skills for layered assets, sprite sheets and batch jobs
  • Runtime introspection of the PDB and GEGL, with typed argument descriptions and enum choices read from GIMP at call time
  • Render, measure, snapshot and compare so the agent verifies each edit before moving on
  • Non-destructive layer effects, selections, masks, text, vector paths and AI subject cut-outs
  • Works inside the GIMP window you already have open: Filters, Development, Start Agent Bridge
  • One Ctrl+Z reverts a whole gimp_edit_batch turn, proven on live GIMP for Windows, Linux and macOS.