Guides
Blender MCP with Codex, Cursor, Gemini CLI and VS Code: one server, any client
Blender MCP with Codex, Cursor, Gemini CLI or VS Code: the config for each client, which server to pick, and tips for reliable results.
3 min read

Quick answer
Can I use Blender MCP with Codex or Cursor?
Yes. Blender MCP servers speak the open Model Context Protocol, so Codex, Cursor, Gemini CLI, VS Code and other MCP clients can use them. You add the same server command to each client's MCP settings, keep Blender open with the add-on's server running, and connect one client at a time.
One Blender MCP server, many clients
MCP is an open protocol. The Blender side, an add-on plus a server process, doesn't care which AI is on the other end. That's why "Blender MCP with Codex", "Blender MCP for Cursor" and "Blender MCP Gemini" are all the same setup with a different config file.
There are two servers to choose from:
- Official Blender MCP from Blender Lab. Entry point
blender-mcp, launched by your client over stdio. - MCP for Blender (community, by Siddharth Ahuja). Launched with
uvx mcp-for-blender.
Which to pick: Blender MCP explained.
Blender MCP with Cursor
The community project documents Cursor directly. Open Settings ‣ MCP (global) or create .cursor/mcp.json in a project, and add a server named blender:
- macOS/Linux:
"command": "uvx","args": ["mcp-for-blender"] - Windows:
"command": "cmd","args": ["/c", "uvx", "mcp-for-blender"]
Then start the server in Blender (N panel ‣ MCP for Blender ‣ Start MCP Server) and reload Cursor.
Blender MCP with Codex CLI
Codex CLI reads MCP servers from its config. Add an entry whose command launches your chosen server (blender-mcp for the official one, or uvx mcp-for-blender), start Blender's server, then start a Codex session in your project folder. Ask Codex to "list the objects in the open Blender scene" to confirm the tools loaded.
Blender MCP with Gemini CLI
Gemini CLI also supports MCP servers in its settings file. Same pattern: register the server command, start the server inside Blender, launch Gemini CLI, and test with a read-only request.
Blender MCP in VS Code
VS Code's agent mode can use MCP servers. Add the server to its MCP configuration and it appears among the agent's tools. This is handy when you're writing a Blender add-on or Python script in VS Code and want the agent to test it against a live Blender.

Rules that apply to every client
- One client at a time. Two clients on one Blender add-on cause dropped connections.
- Restart the client after config changes. MCP servers load at launch.
- Save the .blend first. Every server here runs AI-written Python inside Blender.
- Keep the socket local. The community add-on's socket has no authentication. The official project recommends running in a VM or isolated machine.
- Ask for small steps. Short requests produce scripts that run. Big ones time out.
Which client is best for Blender MCP?
There's no fixed answer: it depends on the model behind each client and changes with every model release. A fair test is the same three tasks in each client:
- "Summarise the scene and list missing textures."
- "Build a 10-step staircase from cubes, 20 cm rise, 30 cm run."
- "Apply all transforms on selected objects and set origins to bottom centre."
Keep whichever runs most of them correctly the first time. For writing Blender Python outside MCP, see best AI for Blender Python.
Models for your agent to place
Agents build well with primitives and code. For detailed props, generate them in Vi3W from a prompt, photo or sketch, with retopology and GLB/FBX/OBJ export, then let Codex, Cursor or Gemini import and arrange them. Try Vi3W.
Frequently asked questions
blender mcp claude vs codex
The Blender side is identical; only the AI model and client change. Try both on the same small task, such as building a fence from primitives, and keep the one whose scripts run first time more often.
blender mcp cursor
In Cursor, add the server in Settings, MCP, or in a project's .cursor/mcp.json. For the community MCP for Blender on Windows, wrap the command as cmd /c uvx mcp-for-blender.
blender mcp vscode
VS Code's agent mode supports MCP servers. Register the Blender MCP server command in its MCP configuration, start the server in Blender, and the tools appear in the agent's tool list.
Last reviewed

