Skip to content
MCP server

GIMP Studio MCP

Let an AI assistant edit images in GIMP 3, including DTF print prep, with 119 tools

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, macOS
Runs
Locally
Version
0.4.0
Listing updated
2 days ago

About GIMP Studio MCP

GIMP Studio MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Built for a working print shop's direct-to-film pipeline, this server drives GIMP 3 so that routine edits do not require the assistant to write GIMP Python. Tools return a structured result with captured errors, a preview image lets the assistant look at the canvas, and checkpoints allow a rollback before risky edits. It can attach to a GIMP window you have open or start a hidden one.

The print-specific tools are the differentiator: setting physical size in inches at a target DPI, trimming to artwork, adding a white underbase, exporting a transparent PNG, and packing several designs onto one 300 DPI sheet. Background removal covers crisp one-colour cutouts, soft colour-to-alpha and a garment-aware knockout that takes a shirt colour such as black or navy.

The 119 tools sit in 13 groups, including layers, masks, selections, paint, text, colour and filters. It needs GIMP 3.x (tested on 3.0.4 and 3.2.4) and Python 3.10 or newer, plus a one-time bridge plugin install. The project is marked beta, unofficial and MIT-style licensed through a LICENSE file.

Install

Run in a terminal

claude mcp add gimp-studio-mcp -- uvx twelvetake-gimp-studio-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gimp-studio-mcp": {
      "command": "uvx",
      "args": [
        "twelvetake-gimp-studio-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gimp-studio-mcp": {
      "command": "uvx",
      "args": [
        "twelvetake-gimp-studio-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gimp-studio-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "twelvetake-gimp-studio-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gimp-studio-mcp": {
      "command": "uvx",
      "args": [
        "twelvetake-gimp-studio-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gimp-studio-mcp": {
      "command": "uvx",
      "args": [
        "twelvetake-gimp-studio-mcp"
      ]
    }
  }
}

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

gimp_exec
Raw script execution escape hatch, with captured output.
get_bitmap
Return a viewable preview of the canvas or a region.
knockout_background
Garment-aware background removal by shirt colour.
cutout_color
Crisp hard one-colour knockout.
foreground_select
Edge-aware subject selection.
checkpoint
Save an image state before a risky edit.
restore
Restore an earlier checkpoint.

What it does

119 structured tools
13 groups covering layers, masks, selections, paint, text, colour, filters and export.
Garment-aware knockout
Removes a background given a shirt colour and picks the technique to match.
DTF print prep
Sets size in inches at a DPI, adds a white underbase and exports transparent PNGs.
Gang sheets
Packs multiple designs onto one 300 DPI print sheet.
Visual feedback
Returns a preview of the canvas or a region so the assistant can check its work.
Checkpoints
Save and restore an image around risky edits.
Live or headless
Attaches to open GIMP or starts a background instance.

Good for

  • Prepare a transparent 300 DPI PNG for a DTF transfer
  • Knock out a shirt-coloured background but keep the same colour inside the art
  • Gang up copies of a design on a 22-inch sheet
  • Crop and clean up a logo by describing the changes

Pricing

Open source

Free; donations accepted

Prices change. Check twelvetake.com before you buy.

GIMP Studio MCP FAQ

Which GIMP versions work?

GIMP 3.x, tested on 3.0.4 and 3.2.4; GIMP 2.x is not supported.

What else is required?

Python 3.10 or newer and a one-time gimp-mcp install-plugin step.

Can I disable raw script execution?

Yes, set GIMP_MCP_NO_EXEC=1 to opt out of gimp_exec.

Is it official?

No. The site calls it an unofficial beta tool.

Is GIMP Studio MCP free?

Yes. GIMP Studio MCP is open source, so you can use and self-host it for free.

How do I add GIMP Studio MCP to Claude Code?

Run this command in your terminal: claude mcp add gimp-studio-mcp -- uvx twelvetake-gimp-studio-mcp

What are the best alternatives to GIMP Studio MCP?

The closest alternatives to GIMP Studio MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to GIMP Studio MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media