MCP server for OpenAI GPT image generation and editing
Connect MCP Openai Image to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP server for OpenAI GPT image generation and editing. The mcp openai image mcp server is what makes that connection.
A Model Context Protocol (MCP) tool server for OpenAI's GPT-4o/gpt-image-1 image generation and editing APIs.
openai-gpt-image-mcp-199bio on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Supports — Claude Desktop, Cursor, VSCode, Windsurf, and any MCP-compatible clientcreate-image — Generate images from a prompt, with advanced options (size, quality, background, etc)edit-image — Edit or extend images using a prompt and optional mask, supporting both file paths and base64 inputVSCode — CursorSquare — 1:1, square, 4:3, 3:4 → 1024x1024Landscape — 16:9, landscape, 3:2 → 1536x1024Portrait — 9:16, portrait, 2:3 → 1024x1536Auto — auto → Let OpenAI choose the best sizeBuild — yarn buildRun — node dist/index.jsWindows — Drive letter followed by : (e.g., C:/path/to/image.png or C:\path\to\image.png)Fallback — If the default directory cannot be created, images will be saved to /tmp (or the directory set by the MCP_HF_WORK_DIR environment variable)Configuration is passed through the environment: OPENAI_API_KEY, MCP_HF_WORK_DIR. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Among the AI and media services options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. MCP Openai Image's toolset — Supports, create-image, edit-image and 10 more — is a fair guide to whether it matches your workflow. It is maintained by 199-biotechnologies; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| Supports | Claude Desktop, Cursor, VSCode, Windsurf, and any MCP-compatible client. |
| create-image | Generate images from a prompt, with advanced options (size, quality, background, etc). |
| edit-image | Edit or extend images using a prompt and optional mask, supporting both file paths and base64 input. |
| VSCode | Cursor |
| Square | 1:1, square, 4:3, 3:4 → 1024x1024 |
| Landscape | 16:9, landscape, 3:2 → 1536x1024 |
| Portrait | 9:16, portrait, 2:3 → 1024x1536 |
| Auto | auto → Let OpenAI choose the best size |
| Build | yarn build |
| Run | node dist/index.js |
| Windows | Drive letter followed by : (e.g., C:/path/to/image.png or C:\path\to\image.png) |
| Fallback | If the default directory cannot be created, images will be saved to /tmp (or the directory set by the MCP_HF_WORK_DIR environment variable) |
| MCP_HF_WORK_DIR | Set this to control the fallback directory for large images and file outputs. Example: export MCP_HF_WORK_DIR=/your/desired/dir |
{
"mcpServers": {
"openai-gpt-image": {
"command": "npx",
"args": ["openai-gpt-image-mcp-199bio"],
"env": {
"OPENAI_API_KEY": "sk-..."
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| OPENAI_API_KEY | Credential the server authenticates with. | Yes |
| MCP_HF_WORK_DIR | Filesystem location the server is allowed to use. | Optional |
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Answers, not links — delegate questions to Perplexity's search-grounded models and get cited responses back.
Give your assistant a voice — text-to-speech, voice cloning and audio tools from the ElevenLabs API.
Give your assistant a real code sandbox — isolated cloud VMs for actually running the code it writes.
The ML hub in your context window — search models, datasets, papers and run Spaces from the official server.
Thousands of open models on tap — run image, video and audio generation through Replicate's hosted API.