MCP for Blender works with any MCP-compatible client. Below are step-by-step configurations for every supported client. Only run one client instance at a time, because multiple clients trying to connect to the same server will conflict.
Only run ONE instance of the MCP server at a time. Do not connect both Claude Desktop and Cursor to MCP for Blender simultaneously.
Claude Desktop uses a JSON config file to register MCP servers. Watch the setup video or follow the steps below.
Open the config file
In Claude Desktop, go to Settings → Developer → Edit Config to open
claude_desktop_config.json.Add the MCP for Blender entry
Paste this JSON inside the
mcpServersobject:{ "mcpServers": { "blender": { "command": "uvx", "args": ["mcp-for-blender"] } } }Fully quit and relaunch Claude Desktop
On macOS, press Cmd+Q to fully quit. On Windows, quit from the system tray icon. Reopen Claude Desktop so it reloads the config.
Claude Code is a terminal-based client. Add MCP for Blender with a single command:
claude mcp add blender uvx mcp-for-blenderThis registers the server automatically. Restart Claude Code if it was already running.
The Codex CLI, desktop app, and IDE extension all share the same config file (~/.codex/config.toml), so setting the server up once covers all three.
Register the server
Use the Codex CLI:
codex mcp add blender -- uvx mcp-for-blenderOr add it by hand to
~/.codex/config.toml(or$CODEX_HOME/config.toml):[mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]Or in the Codex desktop app: Settings → MCP servers → Add server, name it
blender, pick STDIO, enteruvx mcp-for-blenderas the command, then Save and restart. If the app can't finduvx, use its full path instead. See the Installation page for PATH troubleshooting.Verify it registered
Run
codex mcp listand confirm theblenderserver shows as enabled. The tools become available the next time you start Codex.Set environment variables (optional)
To use a non-default Blender host or port, pass
--env KEY=VALUEflags tocodex mcp add, or add them in the config file:[mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"] env = { BLENDER_HOST = "localhost", BLENDER_PORT = "9876" }
Cursor registers MCP servers through its settings UI. Watch the setup video or follow the steps below.
Open MCP settings
Use the one-click install link, or go to Settings → MCP. Add it as a global server, or create
.cursor/mcp.jsonin your project root for a project-specific server.Paste the config JSON
On macOS, paste this JSON directly:
{ "command": "uvx", "args": ["mcp-for-blender"] }Windows users: use cmd wrapper
On Windows, use this instead so Cursor can resolve
uvx:{ "command": "cmd", "args": ["/c", "uvx", "mcp-for-blender"] }
VS Code supports MCP servers through its agent and copilot features.
Add this to your VS Code MCP configuration:
{
"servers": {
"blender": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Restart VS Code after saving the config.
OpenCode uses a top-level mcp key with a local server type and a command array.
{
"mcp": {
"blender": {
"type": "local",
"command": ["uvx", "mcp-for-blender"],
"enabled": true
}
}
}Save the config and restart OpenCode to apply changes.
Antigravity supports environment variables alongside the command config.
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"],
"env": {
"BLENDER_HOST": "localhost",
"BLENDER_PORT": "9876"
}
}
}
}Restart Antigravity after updating the configuration.
If your client cannot find uvx, use the full path from which uvx (macOS/Linux) or where uvx (Windows) as the "command" value. See the Installation page for detailed PATH troubleshooting.