Skip to content
Photoroom MCP for Codex

Image editing for OpenAI Codex

Connect Photoroom to Codex and edit product photos from the terminal, app or IDE: cutouts, shadows, ghost mannequin and more. When an edit needs to run on every upload, Codex writes the API integration from our docs.
Codex sending a sweater and a hoodie shot on floors to Photoroom, with ghost mannequin results

Add Photoroom to Codex

Use https://mcp.photoroom.com/mcp-api if you have an API subscription, or https://mcp.photoroom.com/mcp if you have Pro, Max or Ultra. The Codex CLI, desktop app and IDE extension share one configuration, so you add the server once and it's there in all three.
Codex CLI commands that add Photoroom, sign in and list MCP servers (API connector address)
Codex CLI

Run codex mcp add photoroom --url https://mcp.photoroom.com/mcp-api with an API subscription (or the /mcp address with Pro, Max or Ultra), then codex mcp login photoroom to sign in. codex mcp list shows the server once it's added.

Codex app MCP server settings with Streamable HTTP and the Photoroom URL (API connector address)
Codex app

Open Settings > MCP servers > Add server. Choose Streamable HTTP, enter https://mcp.photoroom.com/mcp-api with an API subscription (or https://mcp.photoroom.com/mcp with Pro, Max or Ultra) and save. Restart, then authenticate.

IDE extension MCP server settings with Streamable HTTP and the Photoroom URL (API connector address)
IDE extension

Open the gear menu > MCP servers > Add server. Choose Streamable HTTP, enter the same URL and save. Restart the extension, then authenticate.

Trusted by leading companies

API connector or Photoroom MCP: which to connect

Your Photoroom plan decides it, not the agent you use. Not on a plan yet? Pick by the work: building edits into your own product or pipeline suits an API plan, and asking for images as you need them suits Pro, Max or Ultra.

API connector, for API subscriptions

Connect while signed in to your API space, and Codex calls the Photoroom API with your key, on your API credits. It's the route for edits on every upload and the integration Codex writes.

Photoroom MCP, for Pro, Max and Ultra

Codex gets the Photoroom app's tools: cutouts, shadows, ghost mannequin, virtual try-on and more, on your plan's credits, with no API key to manage.

Enterprise, for catalog-scale teams

On an Enterprise plan, how you connect depends on your contract, which your account team will decide with you. Enterprise can also add tailored multi-tool workflows and checks on every output.

Codex image editing with Photoroom tools

Background removal, shadows, relighting, ghost mannequin, flat lay and more. Describe the edit and Codex calls the tool.

Photoroom MCP

Connect the Photoroom MCP to the LLM where you work and automate your product listing visuals.

Background Removal

The AI background removal API detects complex edges, handles transparency, and delivers clean cutouts at scale - ideal for product catalogs and marketplace listings.

Virtual Model

Place apparel and accessories on AI-generated models that match your brand aesthetic. On-model imagery via the Virtual Model API: no casting, no studio, no production timelines.

Flat Lay

Generate consistent, editorial-quality flat lay product photography at enterprise scale. Maintain visual identity across thousands of SKUs through the Flat Lay API.

Ghost Mannequin

Produce ghost mannequin apparel shots with perfect shape retention through an AI-powered Ghost Mannequin API endpoint. Scale invisible mannequin photography without a studio.

Product Staging

Place your product into realistic lifestyle scenes - held, worn, or displayed - with the natural lighting and composition of a high-end photoshoot.

Edit With AI

Describe any change in plain language and our AI makes it - swap colors, remove or add objects, restage the scene, or shift the camera angle.

Product Beautifier

Enhance low-quality product and food images automatically with the Beautifier API. No retouchers, no studios. Our AI restores detail, corrects color, and improves overall quality at scale.

Add Shadows

Add realistic shadows to the main subject of your image, with complete control over the softness, intensity and position of the shadow.

Generate Backgrounds

Dynamically create new backgrounds with our first-class generative AI, perfectly matching the subject of the original picture.

Relighting

Fix badly lit photos automatically. Our AI rebalances over- and under-exposed images, with modes that keep product colors accurate or optimize for portraits.

Text Removal

Remove watermarks, labels, and real-world signage from your images automatically - choose what goes and what stays.

Expand

Resize any image to any format without cropping. Our AI generates the extra background to match the original, filling every empty pixel seamlessly.

Uncrop

Recover subjects clipped by the frame. Our AI reconstructs the missing parts from the visible portion, automatically.

Ironing

Make every garment look freshly pressed. Our AI smooths creases and wrinkles out of clothing photos automatically - no steamer, no reshoot.

Create Any Image

Generate images from a text description alone - no source photo needed. Describe the scene, pick a format, and get original content back.

Uncertainty Score

Know when a cutout needs a second look. Every response returns a confidence score from 0 to 1, so you can auto-flag ambiguous images for review at scale.

Perspective Correction

Straighten angled shots of flat, rectangular products - cards, books, games - into clean, straight-on views. No generative AI, so hallucinations are impossible by design.

Positioning

Control exactly where the subject sits in the result - scaling, alignment, padding, and margins - so every image in a catalog comes out consistently framed.

Smart Cropping

Reframe images around the subject automatically - prompt it to focus on a specific element, or crop faces out for marketplace compliance.

Upscale

Turn small, low-res images into sharp ones at 4× the size - with a fast mode for volume and a slow mode for maximum quality.

Product photos, fixed where you write code

Photoroom does the editing, Codex runs it and keeps going, so the work stays in one session.
Green striped rugby shirt photographed wrinkled on a wooden table, then as a smooth, clean cutout on white

Messy uploads, cleaned up from Codex

Your users upload whatever they shot: a phone photo on a bed, a cluttered table, bad light. Point Codex at a folder of uploads, and Photoroom sends them back as clean, listing-ready product photos.

Track jacket, flare jeans and white shirt, each shown as a flat lay and as a ghost mannequin shot side by side

Pick the look your catalog will use

Building a catalog tool or a resale flow? Put the same products in each look, ghost mannequin or flat lay, white background or staged scene, and build in the one your team signs off.

Codex asked to run ghost mannequin on every upload, and the API code it writes from the docs

From a few edits to every upload

Once every new product needs the same treatment, give Codex our ready-made prompt. It holds the Photoroom API's endpoints and settings, so Codex writes, runs and debugs the integration code for you.

The editing Codex calls, proven on real catalogs

4x

faster market rollouts

89%

lower image processing costs

56%

higher conversion on listings

236%

increase in average order value

Exclusive to Enterprise plans

Catalog pipelines that can't ship a bad image

For catalogs too large to check by hand, Enterprise plans can add a workflow shaped to your brief and a fidelity check on every image before it goes live.
Collage of a beige duffel bag with green straps, showing its exterior, spacious interior with pockets, and a hand holding it.
Visual Agents
Visual Agents execute the perfect workflow for your use case. They analyze every input, generate and edit, score the output, retry until it passes. Every visual runs the same loop and only the ones that pass reach your catalog.
Three images of a woman in a yellow blazer, each with a completion score: 83%, 92%, and 100% labeled as "Best fidelity."
Visual QA
Even the best AI models get it wrong, so Visual QA scores every output for fidelity, catches the misses, and corrects the details before they reach your customers.
Collage of a woman in a white halter dress, a bowl of vibrant poke, and a woman holding a mustard handbag with hoop earrings.
Enterprise Guarantee
Pay only for outputs that pass. Every output is checked against your brief by our fidelity model, and anything that misses is regenerated before it reaches your team.
Four fashion items with play icons: a brown handbag, sage green mule, person in a gray shirt and cardigan, and white sneakers with orange accents.
Image to Video API
The Image to Video API turns static product photography into short-form video automatically. Submit a product image and receive a polished video with natural camera motion, animation, or configured effects.
Photoroom MCP

Product edits today, the integration tomorrow

Connect once to edit your own product photos, then let Codex build the integration that runs those edits on every new listing.

Frequently asked questions

How do I add image editing to OpenAI Codex?

Add the Photoroom MCP server. Use https://mcp.photoroom.com/mcp-api with an API subscription, or https://mcp.photoroom.com/mcp with Pro, Max or Ultra. In the Codex CLI, run codex mcp add photoroom --url with that address, then codex mcp login photoroom. In the Codex app or IDE extension, open MCP servers > Add server, choose Streamable HTTP and enter the same address. Codex can then call Photoroom's editing tools when you describe an edit.

Why use Photoroom for product images in Codex?

Photoroom's tools are built for product photos: background removal, relighting, AI shadows, ghost mannequin, flat lay, ironing, product staging and much more. An edit you like in Codex can later go into your product through the Photoroom API. See ghost mannequin photography for what a good result looks like.

Which Photoroom tools can Codex use?

Codex can call Photoroom editing tools. For apparel that means Ghost Mannequin, Flat Lay and AI Ironing, alongside background removal, relighting, shadows and more.

Should I use the MCP or have Codex write an API integration?

In Codex, the MCP suits edits you ask for as you go, and the prompt for coding agents gets Codex to write code that edits without you; the MCP or API guide explains when each one fits.

Where does Codex store the Photoroom server settings?

In ~/.codex/config.toml, shared by the CLI, the app and the IDE extension (with Pro, Max or Ultra, the url ends in /mcp instead):

[mcp_servers.photoroom]
url = "https://mcp.photoroom.com/mcp-api"

Which plan do I need?

On a self-serve plan, it depends on your subscription. If you have an API subscription, use mcp.photoroom.com/mcp-api. If you have Pro, Max or Ultra, use mcp.photoroom.com/mcp. Edits through mcp.photoroom.com/mcp use Pro, Max or Ultra credits, and edits through mcp.photoroom.com/mcp-api use API credits from a separate API subscription. API prices are on the API pricing page. While Codex builds an API integration, a sandbox key gives 1,000 free watermarked calls a month on the Image Editing API, up to 100 a day. On an Enterprise plan or feel it might be right for you? Talk to your account team.

What file formats and sizes does Photoroom accept?

Photoroom takes PNG, JPEG and WebP images up to 30 MB and 5,000 px on the longest side. Results come back as PNG unless you ask for another format; choose PNG or WebP when you need a transparent background. The docs list every setting.

Does Photoroom work in other coding agents?

Yes, the same server works in Claude Code and in Cursor. The Photoroom MCP page lists every app and how each one connects.

Where can I get help?

Visit the Photoroom Help Center for app, plan and account questions. Enterprise customers can contact their account team.

Using the API connector or building with the API? Join our API community to get help from our engineers, or check the troubleshooting page for common issues.

Start selling at first sight

Get listing-ready product visuals in seconds.