GIMP 3 MCP server
io.github.tifyr/gimp3-mcp·v0.2.0Let AI assistants paint, edit and export images in a running GIMP 3, with 80 tools.
0 stars
Reviews
Write oneNobody has reviewed GIMP 3 MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
GIMP 3 MCP tools (80, 8 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_textAdd a text layer to an image.
adjust_brightness_contrastAdjust brightness and contrast of a layer.
adjust_color_balanceAdjust color balance (shadows / midtones / highlights) of a layer.
adjust_curvesAdjust tonal curves for a layer.
adjust_hue_saturationAdjust hue, saturation, and lightness of a layer.
apply_drop_shadowwrite actionApply a drop shadow effect to a layer.
apply_embossApply an emboss (bas-relief) effect to a layer.
apply_gaussian_blurApply Gaussian blur as a destructive filter operation.
apply_noiseAdd noise/grain to a layer.
apply_pixelatePixelate a layer using a mosaic/block effect.
apply_vignetteApply a vignette darkening effect around the edges of a layer.
auto_levelsAutomatically stretch the tonal range of an image (auto levels / auto stretch contrast).
batch_exportExport all open images (or a specific one) to a directory.
batch_resizeResize all open images to a common target size.
blurApply Gaussian blur to a layer.
call_apicheck_serverCheck whether the GIMP MCP plugin socket is reachable and responding.
close_imageClose an image, optionally saving as XCF first.
convert_color_modeConvert an image to a different color mode.
create_layerwrite actionCreate and insert a new layer into an image.
crop_to_rectCrop the image canvas to an explicit rectangle.
crop_to_selectionCrop the image canvas to the current selection bounds.
delete_layerwrite actionDelete a layer from an image.
denoiseReduce noise in a layer using GEGL noise-reduction.
desaturateConvert a layer to grayscale (desaturate).
draw_ellipseDraw an ellipse outline (stroke only) on a layer.
draw_lineDraw a straight line on a layer.
draw_rectangleDraw a rectangle outline (stroke only) on a layer.
duplicate_layerDuplicate a layer and insert the copy above it.
edit_textEdit an existing text layer's content or formatting.
export_icon_sizesExport an image as a complete icon set for Android or iOS.
export_imageExport the current image to a raster file (PNG, JPEG, WEBP, TIFF).
export_social_media_kitExport an image resized for multiple social media platforms.
export_sprite_sheetCombine multiple frames into a sprite sheet PNG.
export_web_optimizedExport an image as both JPEG and PNG, choosing the smaller format.
fill_ellipseFill an elliptical region with a solid color.
fill_layerFill an entire layer with a solid color.
fill_rectangleFill a rectangular region with a solid color.
fill_selectionFill the current selection with a color or fill type.
flatten_imageFlatten all layers into a single background layer.
flip_imageFlip the entire image horizontally or vertically.
get_context_stateGet the current GIMP context state (colors, brush, settings).
get_gimp_infoGet comprehensive information about the GIMP installation and environment.
get_histogramGet histogram statistics for one channel of a layer.
get_image_bitmapGet an open image in GIMP as an Image object with optional scaling and region selection.
get_image_metadataGet metadata about an open image in GIMP without the bitmap data.
get_pixel_colorGet the color of a single pixel.
get_selection_boundsGet the bounding rectangle of the current selection.
get_state_snapshotReturn a live visual snapshot of the current image state — no file save needed.
gradient_fillFill a layer or selection with a gradient.
invert_colorsInvert all colors in a layer (create a negative).
invert_selectionInvert the current selection (select what is not selected).
list_brushesList brushes available to paint_stroke.
list_fontsList fonts installed in GIMP.
list_imagesList all images currently open in GIMP.
list_layersList all layers in an image with their properties.
merge_visible_layersMerge all visible layers into a single layer.
modify_selectionGrow, shrink, feather, border, or sharpen the current selection.
new_canvaswrite actionCreate a new blank canvas in GIMP and open it in a display window.
open_imageOpen an image file in GIMP and create a display window.
paint_strokerename_layerRename a layer.
reorder_layerMove a layer to a new stack position.
resize_canvasResize the image canvas without scaling the content.
restart_serverwrite actionDrop and re-establish the connection to the GIMP MCP plugin.
rotate_imageRotate the entire image.
sample_colorPick a color from the canvas, like a painter's eyedropper.
save_xcfSave the current image as a GIMP XCF file (preserves all layers and metadata).
scale_imageScale an image to exact pixel dimensions.
scale_to_fitScale an image to fit within a bounding box, preserving aspect ratio.
select_allSelect the entire image canvas.
select_by_colorSelect regions by color similarity.
select_ellipsewrite actionCreate an elliptical selection.
select_nonewrite actionRemove / deselect all selections.
select_rectanglewrite actionCreate a rectangular selection.
set_active_imageRaise a specific image's window to the front in GIMP.
set_colorsSet the GIMP foreground and/or background color.
set_layer_propertiesSet properties on an existing layer.
sharpenSharpen a layer using unsharp mask.
warp_regionDisabled: always returns an error and leaves the image unchanged.
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan13 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 17 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (1)
- mediumeval / new Function used
exec.evalgimp3_mcp-0.2.0/gimp-mcp-plugin.py: …a[1]}") vals = [str(eval(e)) for e in a[1]] r…
How GIMP 3 MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 80
- the typical server has 7
- Tools that change things
- 10%
- typical: 0%. Fewer write tools means less an agent can break
What its tools let an agent do: 56 read · 5 create · 11 change · 1 delete · 7 run or deploy
Install GIMP 3 MCP in Claude Code, Cursor or VS Code
claude mcp add gimp3-mcp -- uvx gimp3-mcp
What the publisher says
From the GIMP 3 MCP repository's README, as published. We do not edit it. Read it on GitHub
gimp3-mcp
<!-- mcp-name: io.github.tifyr/gimp3-mcp -->
gimp3-mcp lets an AI assistant work in a running GIMP 3.2. You describe what you want; the assistant creates or opens images, paints, edits, and exports them, and looks at the image between steps to check its work.
It has two parts: a GIMP plugin that runs inside GIMP, and an MCP server that your AI client (Claude Desktop, Claude Code, or any other MCP client) starts. Together they give the assistant 80 tools, from brush strokes and color adjustments to layers, text, and batch export.
gimp3-mcp started as a fork of gimp-mcp by maorcc and its contributors, and is now developed separately. See Credits and How it differs from gimp-mcp.
What you can ask for
Each example is a prompt you can give the assistant, followed by the tools it will typically use.
Paint a picture
Create an 800×800 canvas and paint a ginger cat sitting front-on, in loose painterly strokes.
Look at the canvas after each round of strokes.newcanvas → paintstroke in rounds (textured brushes, tapered strokes, smudging) → getstatesnapshot or the preview option to look → sample_color to pick up colors already on the canvas.
Touch up a photo
Open ~/Pictures/harbor.jpg, auto-level it, add a little contrast and warmth,
sharpen slightly, and export a 2048-pixel-wide JPEG to ~/Pictures/harbor-edit.jpg.openimage → autolevels → adjustbrightnesscontrast → adjustcolorbalance → sharpen → scaletofit → export_image.
Make a graphic
Make a 1200×630 banner with a dark navy background (#1b2a4a) and the title "Summer Sale"
in large white text with a soft drop shadow, then export it for the web.newcanvas → addtext → applydropshadow → exportweboptimized.
Inspect details
Show me the top-left 300×300 pixels of the current image, enlarged.getstatesnapshot with a region.
Work with many images
Export every open image as WebP into ~/Desktop/export.listimages → batchexport.
Anything the tools don't cover
Use GIMP's Python API to list every path in the image and how many strokes each has.call_api runs Python inside GIMP.
What tool calls look like
The assistant writes these calls, not you, but they show what the tools accept. Each block is the arguments for the named tool.
getstatesnapshot: look at part of an image (coordinates are image pixels; the result is scaled to fit max_size):
{"image_index": 0, "max_size": 512,
"region": {"x": 140, "y": 80, "width": 240, "height": 300}}paint_stroke: paint a round of strokes and get a preview back:
{"preview": true, "strokes": [
{"points": [[100, 400], [300, 330], [520, 380]], "brush": "Oils 01", "size": 120, "color": "#3b6e8f"},
{"points": [[140, 420], [300, 370]], "brush": "Bristles 02", "size": 40, "color": "#d9a441", "opacity": 80},
{"points": [[250, 360], [330, 350]], "tool": "smudge", "size": 50, "pressure": "none", "strength": 40}
]}call_api: evaluate Python inside GIMP:
{"api_path": "exec", "args": ["pyGObject-eval", ["len(Gimp.get_images())"]]}How it works
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
GIMP 3 MCP: common questions
- Is GIMP 3 MCP server safe?
- Mostly: it is graded B (83/100). Read the GIMP 3 MCP safety report
- How do I install GIMP 3 MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does GIMP 3 MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is GIMP 3 MCP maintained?
- The last commit was 49 days ago (2026-09-16). The latest release is v0.2.0.
- How does GIMP 3 MCP compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 80 (the typical server has 7); tools that change things 10% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.