gimp-mcp

Overview

GIMP MCP bridges GIMP's professional image editing capabilities with AI assistants through the Model Context Protocol. It enables users to edit images by describing what they want in natural language, with the AI able to verify each change through live visual feedback. The server supports fully autonomous multi-step workflows, from opening and editing images to verification and export. Key features include 56 dedicated tool commands covering all major GIMP operations and the ability to get state snapshots without saving to disk.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• get_state_snapshotget_state_snapshot(image_index, max_size, region, label)

  Returns a live PNG of the current image state

  Try:Show me a snapshot of the current imageTry:Zoom into the face region and show me a detailed snapshot
• adjust_brightness_contrast

  Adjust brightness and contrast of the image

  Try:Make the image brighterTry:Increase contrast and reduce brightness
• scale_image

  Scale the image to exact dimensions

  Try:Scale the image to 800x600 pixelsTry:Make the image 50% smaller
• select_rectangle

  Create a rectangular selection

  Try:Select a rectangle around the center of the imageTry:Select the top-left corner area
• create_layer

  Create a new empty layer

  Try:Create a new layer for editingTry:Add a layer named 'background'
• fill_selection

  Fill the current selection with a color

  Try:Fill the selection with whiteTry:Fill the selected area with transparent color
• add_text

  Add a text layer to the image

  Try:Add the text 'Hello World' at the topTry:Write 'Sample' in bold at the bottom
• apply_gaussian_blur

  Apply a Gaussian blur filter to the image

  Try:Blur the backgroundTry:Apply a light blur to the entire image
• open_image

  Open an image file

  Try:Open the file portrait.jpgTry:Load the image from my folder
• export_image

  Export the image to a file

  Try:Export as PNGTry:Save the image as JPEG with high quality
• get_image_metadata

  Get metadata about the current image

  Try:Show me image informationTry:What are the dimensions of this image?
• get_context_state

  Get current GIMP context state including colors and brush settings

  Try:What are the current foreground and background colors?Try:Show me the current brush settings

Comparable tools

Installation

git clone https://github.com/maorcc/gimp-mcp.git
cd gimp-mcp
uv sync

mkdir -p ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin
cp gimp-mcp-plugin.py ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/
chmod +x ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/gimp-mcp-plugin.py

mkdir -p ~/Library/Application\ Support/GIMP/3.0/plug-ins/gimp-mcp-plugin
cp gimp-mcp-plugin.py ~/Library/Application\ Support/GIMP/3.0/plug-ins/gimp-mcp-plugin/
chmod +x ~/Library/Application\ Support/GIMP/3.0/plug-ins/gimp-mcp-plugin/gimp-mcp-plugin.py

{
  "mcpServers": {
    "gimp": {
      "command": "uv",
      "args": ["run", "--directory", "/full/path/to/gimp-mcp", "gimp_mcp_server.py"]
    }
  }
}

FAQ

What makes GIMP MCP different from other GIMP integrations?

Unlike other integrations, the AI can see the image at any point without saving to disk using `get_state_snapshot`, supports autonomous multi-step workflows, and provides 56 dedicated tool commands covering all major GIMP operations.

Which versions of GIMP are supported?

GIMP MCP is fully compatible with GIMP 3.2.x, with all breaking API changes resolved and tested (56/56 tools passing).

What AI clients work with GIMP MCP?

GIMP MCP is universal MCP-compatible and works with Claude Desktop, Claude Code, Gemini CLI, PydanticAI, and other MCP-compliant AI assistants.

Compare gimp-mcp with