codex-images-mcp
Uses OpenAI's ChatGPT/Codex Images endpoint to generate and edit images with gpt-image-2, supporting batches, references and masks, native transparency, and exact output sizing.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
codex-images-mcp
Generate and edit images from any MCP client with gpt-image-2 on the ChatGPT plan you already pay for. No OpenAI API key, no per-image bill.
codex-images-mcp is an MCP server for the Codex Images endpoint. It runs locally over stdio, or as a self-hosted HTTP server that your laptop, your VPS agents and your Pi / Gentle Shell sessions can share. Every image comes back as a verifiable artifact: SHA-256, byte count, MIME type and real dimensions.
Unofficial. Not affiliated with or endorsed by OpenAI. It signs in with your own ChatGPT account and uses the same endpoint as the Codex CLI. You are bound by OpenAI's terms for your account, and image generation counts against your plan's limits.
What you get
Two tools:
codex_images(generate/edit) andcodex_images_artifact(fetch an image by URI, inline or through a short-lived signed download).Batches:
parallel,variants,chainandbranded-parallel(every image references a shared anchor for brand-consistent sets).Edits with references and masks: up to five references per request, HTTPS URLs or inline images.
Native transparency: real alpha PNGs from the model, with a warning when a result comes back opaque.
Exact output sizes:
native,exact,fitorcoverpost-processing, so a 1200×630 card is 1200×630.Prompts sent verbatim: no hidden rewriting model in between.
Optional API-key engine: set
CODEX_IMAGES_ENGINE=apiwith anOPENAI_API_KEYto choose the model yourself (Images 2.6gpt-image-2.6-sunburst/-flare), with quality up tomaxand complexity control. This engine is billed to your API account. On the default ChatGPT plan route OpenAI chooses the model, and the API selectors (model,quality,complexity) are ignored.Self-hosting that is safe by default: built-in bearer auth, refuses to listen publicly without a token, SSRF-hardened URL fetching (HTTPS, public addresses only, pinned IP, no redirects), no server paths in results.
Its own ChatGPT session:
codex-images-mcp loginuses a device code and keeps a separate session, so it never rotates (and breaks) your Codex app's sign-in.
Related MCP server: ai-image-gpt-mcp
Quick start (local, stdio)
uvx --from codex-images-mcp codex-images-mcp login # sign in once (device code)
uvx --from codex-images-mcp codex-images-mcp setup # register in Claude Code, Claude Desktop, Codex, Cursor, OpenCodeOr try it from the terminal:
uvx --from codex-images-mcp codex-images-mcp generate "a ceramic mug, studio light" --transparent --prettyAlready signed in to the Codex CLI? codex-images-mcp can use that login read-only until its token expires. It never refreshes it; run login for a session of its own.
Example output
Example outputs from gpt-image-2 via this server. The pictures are resized for this page. A transparent generate, and an edit that sends a reference plus a mask, are written up in docs/examples.md.

The generate on the left used the prompt a ceramic mug, studio light with transparent set. The model returned a 1536×1024 PNG, 1,745,462 bytes, sha256 e0d0338218529ca36e0d64e92eb2737c6794b392343f1a5ab32884a49dab48ba. The edit sent that mug as the reference, with a mask over the front, and asked for a small dark brown stamped coffee bean. It returned a 1536×1024 PNG, sha256 7c5b28d4950f5207c111f875ef9d19349e06be3da43ce1200d2d8d2c678b9ba5. The camera angle shifted slightly. A mask is a hint, and the model may adjust the whole frame.
The generate result is a PNG with a real alpha channel. The checkerboard is only a backdrop, so the transparent background is visible:

Also in this folder: an off-white generate, the edit on a checkerboard, and 1200px transparent PNGs of the generate and the edit.
Self-hosted (HTTP)
export CODEX_IMAGES_HTTP_TOKEN=$(openssl rand -hex 32)
docker compose up -d
docker compose run --rm codex-images codex-images-mcp loginThen point your clients at https://your-host/mcp/ with Authorization: Bearer $CODEX_IMAGES_HTTP_TOKEN. See docs/self-hosting.md for the reverse proxy, signed downloads and every setting.
Pi and Gentle Shell
pi-codex-images is a Pi extension for a self-hosted server. It reads the local files you authorize, sends them inline, and writes verified results atomically into your project:
pi install npm:pi-codex-imagesDocumentation
MCP tools reference: inputs, results, error codes.
CLI:
generate,login,logout,setup,status,uninstall.Self-hosting: Docker, reverse proxy, configuration, security model.
Examples: batches, edits, masks, transparency, exact sizes.
Comparison: how this differs from similar projects.
Credits
codex-images-mcp started as a fork of VelmoAI/codex-imagen by wauwa. The installer and much of the original structure come from there. The OAuth token handling derives from codex-image-gen by Small Turtle 2. The generation engine was replaced with the native Codex Images endpoint, and the prompt-rewriting and chroma-key layers were removed.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate AI images and videos from any compatible MCP client.
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models and 10 tools: up to 4 images per call, SVG vectorization, editing and more. Remote MCP with OAuth, no API keys. Pay per image, no subscription.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server for AI-powered image processing (generate, edit, vary, analyze) supporting OpenAI, Gemini, Ideogram, and custom relay endpoints.-
- FlicenseAqualityDmaintenanceStandalone MCP server and CLI for generating images via ChatGPT backend, with reliable exact file paths and multi-account login support.25-
- FlicenseAqualityCmaintenanceA local MCP server that enables image generation and editing through OpenAI's GPT Image models, including variations, inpainting, cropping, and text overlay with brand fonts.6-
- AlicenseAqualityBmaintenanceGenerate and edit images with your own OpenAI-compatible or Gemini API. This local stdio MCP saves results in your project and retries configured fallback models.4142 npmMIT