clear_history
Clear edit history for the current project. Files saved to custom output paths are never deleted — only files in managed directories (.imgx/ or ~/Pictures/imgx/).
LABSCO SUMMARY
Undo is the tool that changes how you work — without it, every experimental edit is a decision you cannot take back.
Image iteration is inherently exploratory, and a stateless editor punishes exploration: an edit that goes wrong means regenerating and losing everything after the last good state. History with undo and redo makes trying something cheap, which is the difference between converging on what you wanted and settling for what you got. edit_last is the small ergonomic win — mid-iteration nobody knows the filename, they mean 'that one', and the tool understands that. Sessions are what let a second image exist without the first one's history getting in the way.
What it is
An image generation and editing client whose distinguishing feature is state: edits form a history with undo and redo, work is grouped into sessions, and the last image is addressable without naming a file.
What you get
- generate_image and edit_image cover the basics, and edit_last applies new instructions to the most recent result — the call you actually want mid-iteration.
- undo_edit and redo_edit move through the history, so a bad edit costs nothing rather than requiring a regeneration.
- edit_history shows every session, and switch_session returns to a previous image to continue work on it.
- set_output_dir changes where files land, and clear_history resets the current project's history.
- list_providers reports the available image providers and what each can do.
Requirements
An API key for at least one image provider: GEMINI_API_KEY from Google AI Studio, which has a free tier for gemini-2.5-flash-image, or OPENAI_API_KEY.
Setup effort
One command plus a key — npm install -g imgx-mcp, then supply credentials
USE CASES
01
Iterating towards the image you actually wanted
Edit the last result repeatedly without naming files, and undo the steps that went the wrong way instead of starting again.
02
Going back to something you made earlier
Read the edit history across sessions and switch into the one holding the image you want to continue.
03
Fixing one thing about an existing image
Apply the instruction to the specific image rather than regenerating and losing what was already right.
04
Keeping the output where you want it
Set the output directory before a run, and clear the project's history when starting fresh.
10 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
edit_history
Show the full edit history with all sessions
edit_image
Edit an existing image with text instructions
edit_last
Edit the last generated/edited image with new text instructions. Uses the output of the previous generate_image or edit_image call as input.
generate_image
Generate an image from a text prompt
list_providers
List available image providers and their capabilities
redo_edit
Redo a previously undone edit
set_output_dir
Change the default output directory for generated images
switch_session
Switch to a different editing session to continue work on a previous image chain
undo_edit
Undo the last edit, reverting to the previous image state
BEFORE YOU INSTALL
What to know first
Tools you get
10 tools when we connected.
Requires
- npx on PATH
- GEMINI_API_KEY or OPENAI_API_KEY in your environment — at least one
Where it runs
All 9 documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 10 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g imgx-mcpMCP Clients
Claude Code, Gemini CLI
JSON
{
"mcpServers": {
"imgx": {
"command": "npx",
"args": [
"--package=imgx-mcp",
"-y",
"imgx-mcp"
],
"env": {
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Claude Desktop — macOS, Linux
CLAUDE DESKTOP — MACOS, LINUX · JSON
{
"mcpServers": {
"imgx": {
"command": "npx",
"args": [
"--package=imgx-mcp",
"-y",
"imgx-mcp"
],
"env": {
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"IMGX_PROJECT_ROOT": ""
}
}
}
}Claude Desktop — Windows
CLAUDE DESKTOP — WINDOWS · JSON
{
"mcpServers": {
"imgx": {
"command": "cmd",
"args": [
"/c",
"npx",
"--package=imgx-mcp",
"-y",
"imgx-mcp"
],
"env": {
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"IMGX_PROJECT_ROOT": ""
}
}
}
}Codex
CODEX · TOML
[mcp_servers.imgx]
command = "npx"
args = ["--package=imgx-mcp", "-y", "imgx-mcp"]
[mcp_servers.imgx.env]
GEMINI_API_KEY = "<YOUR_GEMINI_API_KEY>"
OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>"Cursor, Windsurf, Continue, Other MCP clients
JSON
{
"mcpServers": {
"imgx": {
"command": "npx",
"args": [
"--package=imgx-mcp",
"-y",
"imgx-mcp"
],
"env": {
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
}
}
}
}
