Ruumix AI
  • Features
  • Pricing
  • MCP
For Business
RuumixAI

Design & shop your room in one place. Upload a photo, get a furnished design, and buy any item directly.

TwitterX (Twitter)DiscordYouTubeYouTubeEmail
Featured on Dofollow.ToolsRuumix - Featured on Startup FameFeatured on Twelve Tools

Editions

For IndividualsFor Business

Product

Design & ShopChristmas DecorMCP guidePricingAbout

Legal

Privacy PolicyTerms of ServiceCookie PolicyContact
© 2026 Ruumix by XSquare Limited
Codex CLI

Use Ruumix MCP with Codex

Connect your Ruumix account, turn a room photo into a design, and revise the saved result from Codex CLI.

Connect RuumixSet up with Ruumix Skill

Set up with your agent

Paste this one-line prompt into the agent you want to connect.

Follow https://www.ruumix.ai/skills/ruumix-mcp-setup/SKILL.md to connect Ruumix MCP in this agent, guide me through sign-in, and verify the connection.

Codex CLI

Follow the steps to add Ruumix MCP, sign in, and verify the connection.

View Codex CLI setup steps
Download SKILL.md

On this page

  • Set up in Codex CLI
  • Generate your first design
  • Check a job or revise a saved version
  • Tips for better room edits
  • Troubleshooting

Ruumix MCP lets Codex CLI check your Ruumix credits, find or create a project, import a room photo, and generate or revise a design. Ruumix saves the results in your account so you can pick up the same project in the web workspace.

Set up in Codex CLI

You’ll need Codex CLI and a Ruumix account with a verified email.

  1. Add Ruumix MCP. Run this command in your terminal.

    codex mcp add ruumix --url https://www.ruumix.ai/api/mcp
  2. Sign in and authorize Ruumix. In your browser, sign in to your Ruumix account and approve access. If the browser doesn’t open automatically, run this command to start authorization.

    codex mcp login ruumix
  3. Verify the connection. Run codex to open a new session and send “Show my available Ruumix credits.” If Codex returns your balance, the connection is working. This check uses no Ruumix credits.

Generate your first design

Use a public HTTPS URL that displays the image file in a private browser window without a sign-in or redirect. If the photo is on your computer, first upload it to a service that provides a direct image link. The import limit is 10 MiB. If you want to try the workflow before using your own photo, copy the link to this illustrative living room image.

Copy the prompt into your Codex session and replace [PHOTO_URL].

Use Ruumix to create a project called Living Room Refresh.
Import this room photo: [PHOTO_URL]
Keep the sofa and seating layout. Try a light oak oval coffee table.
Check my credit balance and ask how many Ruumix credits I’m
willing to spend before submitting the job.
Check the job until the result is ready. Share the saved design,
the project link, and any furniture or retailer links Ruumix returns.

Reply with the maximum number of Ruumix credits you’re willing to spend. Ruumix reserves that amount when you submit the job and charges for actual usage within the limit. Unused credits are released after normal settlement. A failed job can still have charges for completed model calls.

If you prefer to work in an existing project, ask Codex to find it first and confirm which project to use.

Check a job or revise a saved version

Generating a design runs in the background. If it’s still queued or running, ask Codex to check the existing job. If you have the job ID, include it in your message. If a job needs attention, keep the job ID and check its status or contact Ruumix support before submitting again.

Once a design is saved, you can ask for a targeted change.

Find my Living Room Refresh project and use the design we just saved.
Keep its furniture and layout, and make the reading light softer.
Ask for my credit limit before you submit the revision.

The revised design appears as a new version in the same project. Open the project link and select Compare to view two versions side by side. You can also open the retailer links supplied with the design or choose a specific version to continue editing on the web.

Tips for better room edits

  • Start with a clear photo that shows the furniture and doors you want to keep in view.
  • Describe what should stay and what should change. For a revision, pick the saved version and change one thing at a time.
  • Before buying, check the retailer’s dimensions, price and availability against your room and budget.

Troubleshooting

  • Codex can’t see Ruumix. Run codex mcp list in the terminal and check for ruumix. If it’s listed but authorization failed, run codex mcp login ruumix and open a fresh Codex session.
  • The photo won’t import. Check the direct HTTPS URL in a private window and try a smaller image if it exceeds the import limit.
  • The job can’t start for lack of credits. Check the available balance and choose a credit limit you can cover.
  • You want to remove the connection from Codex. Run codex mcp logout ruumix, then codex mcp remove ruumix to remove the server from your Codex configuration.

Read the Ruumix MCP launch announcement.