Skip to content
Photoroom MCP for Claude Code

Image editing in Claude Code

Connect Photoroom with one command, then edit a whole folder of product photos from your terminal: remove backgrounds, add shadows, relight, iron garments and more, without writing an editing script.
Claude Code sending a folder of new arrivals to Photoroom, with six product photos on white

Add Photoroom to Claude Code

Use the MCP for the edits you need today, or let Claude Code write a permanent integration with the Photoroom API.
Terminal command adding Photoroom to Claude Code, then a plain-English edit request (API connector address)
Edit images now: the API connector

With an API subscription, signed in to your API space, run this in your terminal:
claude mcp add --transport http Photoroom https://mcp.photoroom.com/mcp-api
With Pro, Max or Ultra, use https://mcp.photoroom.com/mcp instead. Then ask Claude Code for the edit in plain English.

Claude Code asked to build a Photoroom API integration from the docs prompt
Build it into your code: the API

Paste our ready-made prompt for coding agents into Claude Code and describe what you want to build. Claude Code then writes the code, runs it and fixes what breaks.

Claude app connector settings with the Photoroom server address entered
Already in Claude or Cowork

The same Photoroom MCP works in the Claude app and Cowork as a custom connector. See the Claude setup.

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 Claude Code calls the Photoroom API with your key, on your API credits. It's the route for batch jobs, scheduled runs and integrations.

Photoroom MCP, for Pro, Max and Ultra

Claude Code 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.

Photoroom tools for image editing in Claude Code

Claude Code calls them from a plain-English request, for one product photo or a whole batch.

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.

Your product photos, handled from the terminal

Describe the edit once and Claude Code runs it through Photoroom, whether it's ten photos or a new range.
Grid of activewear product images on white with a 150 images progress badge

A whole product folder, edited without a script

Editing product photos one at a time, or writing a throwaway script for each job, slows every launch. With Photoroom in Claude Code, point it at a folder or a list of image links and Photoroom applies the edit you described to each one.

Claude Code setting up a weekly Photoroom edit on new arrivals, with four edited products

New arrivals edited on a schedule

Retail and marketplace teams get fresh product shots every week. Set Claude Code to run the same Photoroom edits on each new batch, including on a schedule, so a new range matches the rest of your catalog without anyone opening an editor.

Three wrinkle-free garments on a beige background: a purple shirt, a striped polo and an orange vest

Edit today, build the integration when you're ready

Start with the MCP for today's edits. When the job becomes part of your product or pipeline, hand Claude Code the prompt from our docs and it builds the API integration, so you never start from a blank file.

Prompts to try

Terminal prompts for your next batch

Swap in your own folder, file or look. Each one runs every image through Photoroom.

Folder to white background

“With Photoroom, remove the background from every image in ./products and place each one on pure white.”

URL list with shadows

“Read urls.txt and, with Photoroom, add a soft natural shadow to each product image.”

Ghost mannequin shoot

“With Photoroom, turn the shirt photos in ./shoot into ghost mannequin shots on white.”

Ironing

“With Photoroom, remove the wrinkles from every garment photo in ./new-arrivals.”

Relight

“With Photoroom, fix the lighting on the photos in ./returns and keep their original backgrounds.”

Flat lay

“With Photoroom, turn these clothing photos into flat lay shots on a light background.”

Build it in

“Read the Photoroom coding agent prompt and write a script that removes the background from every new image in ./uploads.”

From a folder of raw shots to listing-ready images

Point Claude Code at the folder and describe the look. Each photo goes through Photoroom in turn: background removed, shadow added, sized for each marketplace.

Results from teams editing with the Photoroom API at scale

4x

faster market rollouts

89%

lower image processing costs

56%

higher conversion on listings

236%

increase in average order value

Exclusive to Enterprise plans

When a terminal batch becomes a catalog pipeline

Once that batch has to cover the whole catalog, Enterprise plans can add workflows that chain several Photoroom tools and review each image against its original, set up with our team.
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

Run your next product batch from Claude Code

Connect your API plan for a folder, a list of image URLs or a scheduled run. Once it grows into a catalog pipeline, our team can scope an Enterprise setup with you.

Handbag, earrings, armchair, perfume, teddy bear and heels as raw photos, clean cutouts and styled scenes

Frequently asked questions

How do I add image editing to Claude Code?

Run one command in your terminal. With an API subscription, signed in to your API space: claude mcp add --transport http Photoroom https://mcp.photoroom.com/mcp-api. With Pro, Max or Ultra, use https://mcp.photoroom.com/mcp as the address instead. Then describe the result you want, for example "remove the background from every photo in ./products", and it calls the right Photoroom tool.

Can Claude Code edit images?

Yes, once Photoroom is connected. Claude Code can then cut out backgrounds, cast soft shadows, fix lighting, iron garments, and make flat lay or ghost mannequin shots of your products, and much more, on one image or a folder. The same connector works in Claude and Cowork.

Can I batch edit a folder of product photos from Claude Code?

Yes. Hand Claude Code a directory or a text file of image URLs, and Photoroom edits every image the same way; rerun the job whenever new photos arrive, or on a schedule. Before a big run, the bulk editing guide lists what to standardize first.

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

Use the MCP for edits now, and have Claude Code write the API integration from our ready-made prompt once the edits belong in your own product; MCP or API: which to use compares the two.

Which Photoroom tools can Claude Code use?

With an API subscription, Claude Code calls the Photoroom API, so it can use tools such as ironing, relighting, flat lay and ghost mannequin, on one image or a folder. With Pro, Max or Ultra, it uses the Photoroom app's editing tools.

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. On an Enterprise plan? Talk to your account team.

What image formats and sizes work?

PNG, JPEG and WebP go in and come out. Each file can be up to 30 MB, and anything wider than 5,000 px is scaled down to 5,000 px. The docs list the rest.

Does the Photoroom MCP work in Codex or Cursor too?

Yes. The same server works in other coding agents: see Photoroom in Codex and Photoroom in Cursor for their setup steps.

What should I do if I need 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.