GimpMCP
Integrates with GIMP, allowing AI agents to drive image editing operations including layers, selections, filters, text, transforms, color adjustments, and arbitrary Script-Fu code execution.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
GimpMCP
An MCP server that lets an LLM (Claude Code, Claude Desktop, etc.) drive a running GIMP 3.0 instance — images, layers, selections, gradients, text, transforms, filters, or arbitrary Script-Fu code.
If GIMP's window is open, you watch the edits happen live.
Setup
Install GIMP 3.0.
Install this server:
python -m venv .venv .venv\Scripts\pip install -e .Register it with your MCP client (
claude mcp add, or.mcp.json):{ "mcpServers": { "gimp": { "command": "C:\\path\\to\\GimpMCP\\.venv\\Scripts\\python.exe", "args": ["-m", "gimp_mcp.server"] } } }
Related MCP server: photopea-api
Turn on live mode
In GIMP: Filters ▸ Development ▸ Script-Fu ▸ Script-Fu Server → keep 127.0.0.1 / port
10008 → Start.
That's it. Now ask Claude things like:
open C:\photos\cat.png in GIMP, resize it to 800x600, and export it as cat_small.jpg
and you'll see each step land in the GIMP window.
What it can do
35 tools, grouped:
Images — open, create, export, resize, crop, rotate, flip, flatten, inspect, close
Layers — list, add, duplicate, move, fill, opacity, visibility
Selections — rectangle, ellipse, clear
Paint & type — gradient fill, text layers, font listing
Adjust & filter — blur, sharpen, brightness/contrast, desaturate, invert
Escape hatches —
apply_gegl_filter(any of GIMP's ~400 GEGL filters) andrun_script_fu(arbitrary Scheme against the full ~2,000-procedure PDB), withsearch_gimp_apito discover what exists
Run gimp_status any time to check what it's connected to.
Troubleshooting
Problem | Fix |
Tools refuse with a "start the server" hint | GIMP is open but the Script-Fu server isn't running — see Turn on live mode above |
"Can't find GIMP" | Set |
Edits happen but you can't see them | You're on a headless instance; open GIMP and start its Script-Fu server |
A procedure errors out | You're likely hitting a GIMP 2.x name that no longer exists — see the notes below |
Verified on Windows + GIMP 3.0.8. macOS/Linux detection is implemented but untested. GIMP 2.10 is not supported.
Digging deeper
NOTES.md — the GIMP 3.0 PDB changes that trip everyone up (renamed procedures,
the removed plug-in-* filter family, the text-layer footgun), the socket protocol, and how to
find procedures GIMP doesn't document.
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Qwen Image 3 AI image generation
MCP server for AI dialogue using various LLM models via AceDataCloud
Hosted MCP server for AI photo editing: nothing to install, no desktop photo editor needed.
MCP server for Flux AI image generation
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceMCP server that bridges GIMP 3.0 with natural language commands, enabling conversational image editing through Claude Desktop and other MCP clients. Exposes GIMP's full PyGObject API for AI-powered image manipulation.293GPL 3.0
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides headless, read/write access to Photopea for image editing, including layers, text, filters, and document operations, enabling agents to edit images programmatically.5-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that lets AI assistants drive Adobe Photoshop on Windows through ExtendScript and COM automation, offering ~122 tools for documents, layers, text, filters, color, selections, masks, layout QA, and design systems.3MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to create, paint, edit, inspect, and export images in a running GIMP 3.2 instance via MCP.178 PyPIGPL 3.0