Skip to content
MCP Shelf

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.

Terminal
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 the uvx command).
  • Codex: the CLI, the desktop app or the IDE extension. All three share ~/.codex/config.toml.

Install it step by step

  1. Step 1: Add the server with the command at the top of this page. codex mcp list should now show blender as enabled.
  2. Step 2: Install the addon: uvx mcp-for-blender install-addon copies it into Blender's addons folder.
  3. Step 3: Open Blender, go to Edit, Preferences, Add-ons, and enable Interface: MCP for Blender.
  4. Step 4: In the 3D viewport press N, open the MCP for Blender tab and click Start MCP Server.
  5. 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:

Terminal
git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex

Restart 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.

~/.codex/config.toml (the same setup by hand)
[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 seeWhat to do
spawn uvx ENOENTThe app cannot see your terminal PATH. Use the full path to uvx as the command.
Codex has the tools but nothing happens in BlenderClick Start MCP Server in the MCP for Blender tab. The addon must be running.
The first request fails, later ones workA known quirk. Retry once; if it keeps failing, restart Codex and the Blender server.
Install fails with Python errorsPin Python: use args = ["--python", "3.11", "mcp-for-blender"].
Timeouts on big scenesAsk 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.