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.
-
Add Ruumix MCP. Run this command in your terminal.
codex mcp add ruumix --url https://www.ruumix.ai/api/mcp -
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 -
Verify the connection. Run
codexto 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 listin the terminal and check forruumix. If it’s listed but authorization failed, runcodex mcp login ruumixand 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, thencodex mcp remove ruumixto remove the server from your Codex configuration.
