Get Started with MCP for Blender in 4 Steps

MCP for Blender lets you control Blender with natural language prompts via Claude or any MCP-compatible AI client. This guide gets you from zero to your first AI-generated 3D scene. Watch the full walkthrough below, or follow the steps.

1. Install uv

   Install the uv package manager for your platform. Do not install uv through pip; use the official installer.

   brew install uv

   curl -LsSf https://astral.sh/uv/install.sh | sh

   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

   Do not install uv with pip install uv. Use the official installer above to avoid compatibility issues.

2. Add the MCP server to your client

   Register the MCP for Blender server so your AI client can send prompts to Blender.

   Claude Desktop: Add this to your Claude Desktop MCP configuration:

   {
     "mcpServers": {
       "blender": {
         "command": "uvx",
         "args": ["mcp-for-blender"]
       }
     }
   }

   Claude Code:

   claude mcp add blender uvx mcp-for-blender

   Codex:

   codex mcp add blender -- uvx mcp-for-blender

   For Cursor, VS Code, OpenCode, Antigravity, and other clients, see MCP Clients.

3. Install the Blender addon

   Run the install command, then enable the addon inside Blender.

   uvx mcp-for-blender install-addon

   After installation, open Blender and enable the addon:

   1. Go to Edit → Preferences → Add-ons
   2. Search for Interface: MCP for Blender
   3. Check the box to enable it

4. Connect and start the server

   In Blender, press N in the 3D viewport to open the sidebar.

   1. Select the MCP for Blender tab
   2. If it says Not connected, click Connect to MCP server (it usually connects automatically when Blender loads)

   The addon listens on localhost:9876 by default. You can change the port in the same panel; if you do, point the MCP server at it with BLENDER_PORT or --port.

Your first prompt

Open your MCP client and try one of these prompts to see MCP for Blender in action:

• "Create a low poly dungeon scene with a dragon guarding a pot of gold"
• "Create a beach scene using HDRIs, textures, and vegetation from Poly Haven"
• "Create a sphere and place it above the cube"

The AI translates your request into Blender commands and builds the scene in real time.

Next steps