# GIMP Studio MCP

> GIMP Studio MCP is an open-source MCP server for design and media. Let an AI assistant edit images in GIMP 3, including DTF print prep, with 119 tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://twelvetake.com/tools/gimp-studio-mcp/
- **Repository:** https://github.com/twelvetake-studios/gimp-studio-mcp
- **MCP Registry name:** com.twelvetake/gimp-studio-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/gimp-studio-mcp
