# Add to your Claude Code skills
git clone https://github.com/gimp-mcp/gimp-mcpGuides for using mcp servers skills like gimp-mcp.
Last scanned: 11/1/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-11-01T11:03:08.779Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how gimp-mcp compares with popular alternatives.
gimp-mcp is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by gimp-mcp. GIMP MCP server. It has 292 GitHub stars.
Yes. gimp-mcp passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/gimp-mcp/gimp-mcp" and add it to your Claude Code skills directory (see the Installation section above).
gimp-mcp is primarily written in Python. It is open-source under gimp-mcp on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh gimp-mcp against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.

Full demo (with audio): https://github.com/gimp-mcp/gimp-mcp/raw/main/docs/demo.mp4
AI agent using GIMP MCP to remove a background, edit a character's expression, and verify results — all through natural language via Claude
GIMP MCP bridges GIMP's professional image editing capabilities with AI assistants through the Model Context Protocol. It lets you edit images by describing what you want — and gives the AI a live visual feedback channel to verify each change before moving on.
What makes it different from other GIMP integrations:
get_state_snapshot)| 👁️ Live Visual Feedback | get_state_snapshot returns a PNG preview mid-workflow so the AI verifies each step |
| 🎨 79 GIMP Tools | Adjustments, transforms, selections, layers, drawing, text, filters — all via MCP |
| 🔧 GIMP 3.2 Compatible | All GIMP 3.2 API breaks fixed and tested (59/59 passing) |
| 🔁 Iterative Workflows | AI loops until a goal is met — e.g. keeps removing BG until no pixels remain |
| 🖼️ Region Snapshots | Zoom into any area for detail verification (face, mouth, corner, etc.) |
| 🔌 Universal MCP | Works with Claude Desktop, Claude Code, Gemini CLI, PydanticAI, and more |
The AI removes the background, takes a snapshot to inspect the result, detects remaining pixels, and loops until the image is clean:
"Remove the background from this image and keep looping until only the character remains"
"Make the character smile — paint a smile arc with teeth over her mouth"
"Open navi_portrait.png, remove the background, verify it's clean,
then make her smile and export the final result as a PNG"
"Boost the contrast, shift the hue 15 degrees warmer, then show me a before/after zoom of the face"
"Add a bold title at the top in white with a subtle drop shadow, then export for web"
uvx downloads the MCP server and a suitable Python (3.11+) on first useThe MCP server and the GIMP plugin ship together as the gimp-mcp-plugin package on PyPI. No clone needed.
Launch GIMP once (so its config folder exists), close it, then run:
uvx gimp-mcp-plugin@latest install-plugin
This copies the plugin into the newest GIMP 3.x config folder it finds (Linux standard, Snap and Flatpak locations, macOS, Windows) and makes it executable. Restart GIMP afterward.
--dry-run shows where it would install without writing anything.--gimp-dir DIR installs into a specific GIMP config folder, e.g. --gimp-dir ~/.config/GIMP/3.2.If you have more than one GIMP 3 installation (e.g. a system GIMP and a Flatpak), the newest folder found may not be the one your GIMP uses. Check the folder shown in GIMP's Edit → Preferences → Folders → Plug-ins and pass the folder that contains plug-ins with --gimp-dir.
Which folder does GIMP use? GIMP names its per-user folder after its major.minor version (
3.0,3.2,3.4, …) and creates a fresh one on each minor upgrade, so the plug-ins folder moves when you upgrade GIMP. Re-runinstall-pluginafter upgrading. To check the active path, open Edit → Preferences → Folders → Plug-ins in GIMP.
localhost:9877To skip step 2 on every launch, open Tools > MCP > MCP Server Settings..., tick Start MCP server when GIMP launches, and restart GIMP. Autostart is off by default.
The same dialog sets the port (default 9877). If you change it, set GIMP_MCP_PORT
in your MCP client config so the MCP server connects to the same port:
"gimp": {
"command": "uvx",
"args": ["gimp-mcp-plugin@latest"],
"env": { "GIMP_MCP_PORT": "9988" }
}
Settings are saved to gimp-mcp.json in GIMP's per-user config folder (e.g.
~/.config/GIMP/3.2/gimp-mcp.json). Port changes apply the next time the server starts.
The MCP server waits up to 300 seconds for GIMP to finish each command. For heavier work
(large or 16-bit images, slow filters), set GIMP_MCP_TIMEOUT (in seconds) in your MCP
client config, the same way as GIMP_MCP_PORT above, e.g. "GIMP_MCP_TIMEOUT": "900".
check_server reports the timeout in effect. When a command times out, GIMP may still be
running it, so check the image before retrying. Your MCP client may have its own tool
timeout (in Claude Code, MCP_TOOL_TIMEOUT, in milliseconds); raise it too if it's shorter.
gimp-mcp-plugin@latest makes uvx check PyPI for a new release each time your client starts the server.
~/.config/Claude/claude_desktop_config.json (Linux/macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"gimp": {
"command": "uvx",
"args": ["gimp-mcp-plugin@latest"]
}
}
}
claude mcp add gimp-mcp -- uvx gimp-mcp-plugin@latest
~/.config/gemini/.gemini_config.json:
{
"mcpServers": {
"gimp": {
"command": "uvx",
"args": ["gimp-mcp-plugin@latest"]
}
}
}
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStdio
server = MCPServerStdio('uvx', args=['gimp-mcp-plugin@latest'])
agent = Agent('openai:gpt-4o', mcp_servers=[server])
GIMP runs one command at a time, in the order they're sent. While it works, the MCP server stays responsive, so your client can cancel a call. The cancel returns at once: a command that's still waiting its turn never runs, but one GIMP has already started is finished in the background. Check the image before retrying a cancelled edit, or it may be applied twice.
The plugin and the MCP server must be the same version. check_server and get_gimp_info report a mismatch and print the command that fixes it. To update both:
@latest, it picks up the newest server.uvx gimp-mcp-plugin@latest install-plugin and restart GIMP.To work on the code, run the server and install the plugin from a clone instead:
git clone https://github.com/gimp-mcp/gimp-mcp.git
cd gimp-mcp
uv sync
uv run gimp_mcp_server.py install-plugin # installs this checkout's plugin
Then point your MCP client at the checkout, e.g. for Claude Desktop:
"gimp": {
"command": "uv",
"args": ["run", "--directory", "/full/path/to/gimp-mcp", "gimp_mcp_server.py"]
}
Claude Code picks up the repo's .mcp.json automatically when started in the checkout. After git pull, re-run install-plugin if the plugin changed.
get_state_snapshot(image_index, max_size, region, label)Returns a live PNG of the current image state — the AI's primary feedback mechanism. Call this between any edits to verify the result without saving to disk.
# Full image snapshot
snapshot = get_state_snapshot(max_size=512)
# Zoom into a face region for detail inspection
snapshot = get_state_snapshot(
region={"x": 140, "y": 80, "width": 240, "height": 300},
max_size=512,
label="face-check"
)
This enables iterative agentic workflows: edit → snapshot → assess → refine → repeat.
get_image_bitmap(image_index, max_width, max_height, region)Lower-level bitmap fetch with region extraction and scaling. Returns base64-encoded PNG.
| Tool | Description |
|---|---|
adjust_brightness_contrast |
Brightness and contrast |
adjust_curves |
Curves by channel (RGB/R/G/B/A) |
adjust_hue_saturation |
Hue, saturation, lightness |
adjust_color_balance |
Shadows/midtones/highlights color balance |
auto_levels |
Auto-stretch levels |
desaturate |
Convert to grayscale (keep RGB mode) |
invert_colors |
Invert all channels |
convert_color_mode |
Convert between RGB, grayscale, and indexed modes |
sharpen |
Unsharp mask sharpening |
blur |
Gaussian blur |
denoise |
Noise reduction |
| Tool | Description |
|---|---|
scale_image |
Scale to exact dimensions |
scale_to_fit |
Scale within bounding box (aspect-safe) |
crop_to_rect |
Crop to rectangle |
| ` |