> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-for-blender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Started with Blender MCP in 4 Steps

> Install Blender MCP and make your first AI-driven Blender request in under 5 minutes. Requires Blender 3.0+, Python 3.10+, and uv.

Blender MCP 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.

<Frame>
  <iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/lCyQ717DuzQ" title="Blender MCP full tutorial" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

<Note>
  **Prerequisites:** Blender 3.0 or newer, Python 3.10 or newer, and the [uv](https://docs.astral.sh/uv/) package manager.
</Note>

<Steps>
  <Step title="Install uv">
    Install the uv package manager for your platform. Do not install uv through pip; use the official installer.

    <CodeGroup>
      ```bash macOS theme={null}
      brew install uv
      ```

      ```bash Linux theme={null}
      curl -LsSf https://astral.sh/uv/install.sh | sh
      ```

      ```powershell Windows theme={null}
      powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
      ```
    </CodeGroup>

    <Warning>
      Do not install uv with `pip install uv`. Use the official installer above to avoid compatibility issues.
    </Warning>
  </Step>

  <Step title="Add the MCP server to your client">
    Register the Blender MCP server so your AI client can send prompts to Blender.

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

    ```json theme={null}
    {
      "mcpServers": {
        "blender": {
          "command": "uvx",
          "args": ["blender-mcp"]
        }
      }
    }
    ```

    **Claude Code:**

    ```bash theme={null}
    claude mcp add blender uvx blender-mcp
    ```

    For Cursor, Windsurf, and other clients, see [MCP Clients](/mcp-clients).
  </Step>

  <Step title="Install the Blender addon">
    Run the install command, then enable the addon inside Blender.

    ```bash theme={null}
    uvx blender-mcp install-addon
    ```

    After installation, open Blender and enable the addon:

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

  <Step title="Connect and start the server">
    In Blender, press **N** in the 3D viewport to open the sidebar.

    1. Select the **BlenderMCP** tab
    2. Click **Start MCP Server**

    The server listens on `localhost:9876` by default. You can override this with the `BLENDER_HOST` and `BLENDER_PORT` environment variables.
  </Step>
</Steps>

<Tip>
  Only run one instance of the MCP server at a time. Do not run it simultaneously in both Cursor and Claude Desktop, for example.
</Tip>

## Your first prompt

Open your MCP client and try one of these prompts to see Blender MCP 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.

<Warning>
  The `execute_blender_code` tool runs arbitrary Python inside Blender. Save your work before using AI-generated code, especially in complex scenes.
</Warning>

## Next steps

<CardGroup cols={3}>
  <Card title="Installation" icon="wrench" href="/installation">
    Advanced setup, environment variables, and credential management.
  </Card>

  <Card title="MCP Clients" icon="monitor" href="/mcp-clients">
    Configure Cursor, Windsurf, and other MCP-compatible clients.
  </Card>

  <Card title="Integrations" icon="puzzle" href="/concepts/integrations-overview">
    Add asset libraries and AI 3D generators to expand your scenes.
  </Card>
</CardGroup>