Pod to App: Codex
How to install Blender MCP in Codex
By Sophie Filer · Updated 11 Nov 2026 · Steps checked against Blender MCP's own docs on 11 Nov 2026
The short answer
Run codex mcp add blender -- uvx mcp-for-blender, install the Blender addon with uvx mcp-for-blender install-addon, then click Start MCP Server in Blender's sidebar. Or run uvx mcp-for-blender setup, which does all three for you.
codex mcp add blender -- uvx mcp-for-blender- Needs
- Blender 3.0+, uv
- Config file
- ~/.codex/config.toml
- Extra
- Codex plugin with live viewport
- Price
- Free, open source
Before you start
- Blender 3.0 or newer.
- uv, the Python package manager, installed with its official installer (not
pip install uv, which may not create theuvxcommand). - Codex: the CLI, the desktop app or the IDE extension. All three share
~/.codex/config.toml.
Install it step by step
- Step 1: Add the server with the command at the top of this page.
codex mcp listshould now show blender as enabled. - Step 2: Install the addon:
uvx mcp-for-blender install-addoncopies it into Blender's addons folder. - Step 3: Open Blender, go to Edit, Preferences, Add-ons, and enable Interface: MCP for Blender.
- Step 4: In the 3D viewport press N, open the MCP for Blender tab and click Start MCP Server.
- Step 5: Restart Codex so it picks up the tools, then ask: "Build a low-poly lighthouse on a rock and light it for sunset."
The Codex plugin: a live viewport in the chat
The project also ships a Codex plugin, which its README recommends. On top of the MCP tools it shows Blender's viewport beside the conversation, lets you click an object to attach it to your next message, and adds pickers for Poly Haven, Sketchfab and Poly Pizza assets. It is not in the Codex plugin directory yet, so you add it from the repository:
git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codexRestart Codex, install MCP for Blender from the plugins directory, and ask Codex to use it.
In the Codex desktop app
Go to Settings, MCP servers, Add server. Name it blender, choose STDIO, enter uvx mcp-for-blender as the command, save and restart. If the app cannot find uvx, put its full path instead, from which uvx on macOS or Linux or where uvx on Windows.
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
env = { BLENDER_HOST = "localhost", BLENDER_PORT = "9876" }Safe mode
By default the agent can run any Python inside Blender. Add BLENDER_MCP_SAFE_MODE = "1" to the env line to have each script checked first: file access, running programs and network calls are blocked, while modelling, materials, rendering and saving still work. Blocked scripts go back to Codex with the reason, so it can try again.
If it does not work
| What you see | What to do |
|---|---|
spawn uvx ENOENT | The app cannot see your terminal PATH. Use the full path to uvx as the command. |
| Codex has the tools but nothing happens in Blender | Click Start MCP Server in the MCP for Blender tab. The addon must be running. |
| The first request fails, later ones work | A known quirk. Retry once; if it keeps failing, restart Codex and the Blender server. |
| Install fails with Python errors | Pin Python: use args = ["--python", "3.11", "mcp-for-blender"]. |
| Timeouts on big scenes | Ask for smaller steps: block out shapes first, then materials, then lighting. |
MCP Shelf take
Is Blender MCP worth adding to Codex?
Blender MCP is one of the few servers that feels like a new ability rather than a shortcut: you describe a scene and watch it appear. Codex is a strong match because the plugin shows the viewport right in the chat, so you can point at an object and say "make this taller". Save your file before you start, since the agent writes and runs real Python in your scene. Turn on safe mode if you share the machine. For serious modelling it is an assistant for blocking out and repetitive work, not a replacement for your own hands.
Sophie Filer
Questions
Is it blender-mcp or mcp-for-blender?
Both work. The package was renamed to mcp-for-blender; uvx blender-mcp still runs the server, so older configs do not need changing.
Do I need the Codex plugin, or is the MCP server enough?
The MCP server alone gives Codex the tools. The plugin adds the live viewport, asset pickers and mentions for scene objects, which make it much easier to steer.
Can Codex see what it built in Blender?
Yes. The look tool returns views of the viewport, camera or several angles, so Codex can check its work and fix it.
Is Blender MCP safe?
It runs Python inside Blender with no sandbox by default, and the addon port has no authentication. Keep it on localhost, save first, and use BLENDER_MCP_SAFE_MODE to block risky code.
Sources: the steps on this page are written in our own words from Blender MCP's own install docs, the README. If they disagree with this page, the project's docs win; please tell us from the server page.
