GIMP Studio MCP
Let an AI assistant edit images in GIMP 3, including DTF print prep, with 119 tools
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"gimp-studio-mcp": {
"command": "uvx",
"args": [
"twelvetake-gimp-studio-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gimp-studio-mcp": {
"command": "uvx",
"args": [
"twelvetake-gimp-studio-mcp"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media