MCP.Market

GIMP 3 MCP server

by tifyr·io.github.tifyr/gimp3-mcp·v0.2.0

Let AI assistants paint, edit and export images in a running GIMP 3, with 80 tools.

B83/100grade B
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • add_text

    Add a text layer to an image.

  • adjust_brightness_contrast

    Adjust brightness and contrast of a layer.

  • adjust_color_balance

    Adjust color balance (shadows / midtones / highlights) of a layer.

  • adjust_curves

    Adjust tonal curves for a layer.

  • adjust_hue_saturation

    Adjust hue, saturation, and lightness of a layer.

  • apply_drop_shadowwrite action

    Apply a drop shadow effect to a layer.

  • apply_emboss

    Apply an emboss (bas-relief) effect to a layer.

  • apply_gaussian_blur

    Apply Gaussian blur as a destructive filter operation.

  • apply_noise

    Add noise/grain to a layer.

  • apply_pixelate

    Pixelate a layer using a mosaic/block effect.

  • apply_vignette

    Apply a vignette darkening effect around the edges of a layer.

  • auto_levels

    Automatically stretch the tonal range of an image (auto levels / auto stretch contrast).

  • batch_export

    Export all open images (or a specific one) to a directory.

  • batch_resize

    Resize all open images to a common target size.

  • blur

    Apply Gaussian blur to a layer.

  • call_api
  • check_server

    Check whether the GIMP MCP plugin socket is reachable and responding.

  • close_image

    Close an image, optionally saving as XCF first.

  • convert_color_mode

    Convert an image to a different color mode.

  • create_layerwrite action

    Create and insert a new layer into an image.

  • crop_to_rect

    Crop the image canvas to an explicit rectangle.

  • crop_to_selection

    Crop the image canvas to the current selection bounds.

  • delete_layerwrite action

    Delete a layer from an image.

  • denoise

    Reduce noise in a layer using GEGL noise-reduction.

  • desaturate

    Convert a layer to grayscale (desaturate).

  • draw_ellipse

    Draw an ellipse outline (stroke only) on a layer.

  • draw_line

    Draw a straight line on a layer.

  • draw_rectangle

    Draw a rectangle outline (stroke only) on a layer.

  • duplicate_layer

    Duplicate a layer and insert the copy above it.

  • edit_text

    Edit an existing text layer's content or formatting.

  • export_icon_sizes

    Export an image as a complete icon set for Android or iOS.

  • export_image

    Export the current image to a raster file (PNG, JPEG, WEBP, TIFF).

  • export_social_media_kit

    Export an image resized for multiple social media platforms.

  • export_sprite_sheet

    Combine multiple frames into a sprite sheet PNG.

  • export_web_optimized

    Export an image as both JPEG and PNG, choosing the smaller format.

  • fill_ellipse

    Fill an elliptical region with a solid color.

  • fill_layer

    Fill an entire layer with a solid color.

  • fill_rectangle

    Fill a rectangular region with a solid color.

  • fill_selection

    Fill the current selection with a color or fill type.

  • flatten_image

    Flatten all layers into a single background layer.

  • flip_image

    Flip the entire image horizontally or vertically.

  • get_context_state

    Get the current GIMP context state (colors, brush, settings).

  • get_gimp_info

    Get comprehensive information about the GIMP installation and environment.

  • get_histogram

    Get histogram statistics for one channel of a layer.

  • get_image_bitmap

    Get an open image in GIMP as an Image object with optional scaling and region selection.

  • get_image_metadata

    Get metadata about an open image in GIMP without the bitmap data.

  • get_pixel_color

    Get the color of a single pixel.

  • get_selection_bounds

    Get the bounding rectangle of the current selection.

  • get_state_snapshot

    Return a live visual snapshot of the current image state — no file save needed.

  • gradient_fill

    Fill a layer or selection with a gradient.

  • invert_colors

    Invert all colors in a layer (create a negative).

  • invert_selection

    Invert the current selection (select what is not selected).

  • list_brushes

    List brushes available to paint_stroke.

  • list_fonts

    List fonts installed in GIMP.

  • list_images

    List all images currently open in GIMP.

  • list_layers

    List all layers in an image with their properties.

  • merge_visible_layers

    Merge all visible layers into a single layer.

  • modify_selection

    Grow, shrink, feather, border, or sharpen the current selection.

  • new_canvaswrite action

    Create a new blank canvas in GIMP and open it in a display window.

  • open_image

    Open an image file in GIMP and create a display window.

  • paint_stroke
  • rename_layer

    Rename a layer.

  • reorder_layer

    Move a layer to a new stack position.

  • resize_canvas

    Resize the image canvas without scaling the content.

  • restart_serverwrite action

    Drop and re-establish the connection to the GIMP MCP plugin.

  • rotate_image

    Rotate the entire image.

  • sample_color

    Pick a color from the canvas, like a painter's eyedropper.

  • save_xcf

    Save the current image as a GIMP XCF file (preserves all layers and metadata).

  • scale_image

    Scale an image to exact pixel dimensions.

  • scale_to_fit

    Scale an image to fit within a bounding box, preserving aspect ratio.

  • select_all

    Select the entire image canvas.

  • select_by_color

    Select regions by color similarity.

  • select_ellipsewrite action

    Create an elliptical selection.

  • select_nonewrite action

    Remove / deselect all selections.

  • select_rectanglewrite action

    Create a rectangular selection.

  • set_active_image

    Raise a specific image's window to the front in GIMP.

  • set_colors

    Set the GIMP foreground and/or background color.

  • set_layer_properties

    Set properties on an existing layer.

  • sharpen

    Sharpen a layer using unsharp mask.

  • warp_region

    Disabled: 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

1 medium
  • 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 usedexec.eval
    gimp3_mcp-0.2.0/gimp-mcp-plugin.py: …a[1]}") vals = [str(eval(e)) for e in a[1]] r…
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.