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

# Blender MCP: Connect Blender to Any AI Model

> Blender MCP connects Blender to Claude and other LLMs via MCP, enabling prompt-driven 3D modeling, scene creation, and manipulation.

Blender MCP bridges Blender and AI models (primarily Claude) through the Model Context Protocol. You describe scenes in plain language, and the AI builds, edits, and manipulates them in real time inside Blender.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get from zero to your first AI-driven 3D scene in under 5 minutes.
  </Card>

  <Card title="Installation" icon="wrench" href="/installation">
    Detailed setup for the MCP server, Blender addon, and supported clients.
  </Card>

  <Card title="Integrations" icon="puzzle" href="/concepts/integrations-overview">
    Connect Poly Haven, Sketchfab, Poly Pizza, Hyper3D Rodin, and Hunyuan3D.
  </Card>

  <Card title="Use Cases" icon="sparkles" href="/use-cases/gaming">
    See how studios and creators use prompt-driven 3D across industries.
  </Card>
</CardGroup>

## How it works

Blender MCP has two parts: a Blender addon that runs a socket server inside Blender, and a Python MCP server (`blender-mcp` on PyPI). The MCP server receives your prompts from Claude or any compatible client, translates them into Blender commands, and streams the results back so you can iterate in seconds.

<Steps>
  <Step title="Install uv">
    Install the [uv](https://docs.astral.sh/uv/) package manager. Blender MCP uses it to run the MCP server and install the addon.
  </Step>

  <Step title="Add the MCP server to your client">
    Register `uvx blender-mcp` with Claude Desktop, Claude Code, or another MCP client.
  </Step>

  <Step title="Install the Blender addon">
    Run `uvx blender-mcp install-addon`, then enable it in Blender under Edit → Preferences → Add-ons → Interface: Blender MCP.
  </Step>

  <Step title="Start the server">
    In Blender, press N in the 3D viewport, open the BlenderMCP tab, and click Start MCP Server.
  </Step>
</Steps>

## Integrations

Connect external asset libraries and AI 3D generators to expand what your prompts can produce.

<CardGroup cols={3}>
  <Card title="Poly Haven" icon="image" href="/integrations/poly-haven">
    Free HDRIs, textures, and 3D models.
  </Card>

  <Card title="Sketchfab" icon="box" href="/integrations/sketchfab">
    Realistic models. API key required.
  </Card>

  <Card title="Poly Pizza" icon="pizza" href="/integrations/poly-pizza">
    Low-poly models. \~10,600 free assets.
  </Card>

  <Card title="Hyper3D Rodin" icon="wand" href="/integrations/hyper3d-rodin">
    AI 3D generation from text or images.
  </Card>

  <Card title="Hunyuan3D" icon="cube" href="/integrations/hunyuan3d">
    AI 3D generation by Tencent.
  </Card>
</CardGroup>

## Requirements

* Blender 3.0 or newer
* Python 3.10 or newer
* [uv](https://docs.astral.sh/uv/) package manager

<Note>
  Blender MCP communicates over JSON on a TCP socket at `localhost:9876`. You can change the host and port with the `BLENDER_HOST` and `BLENDER_PORT` environment variables.
</Note>

## Community

Join the [Discord](https://discord.gg/SNqPn4TcKQ) or explore the source on [GitHub](https://github.com/ahujasid/blender-mcp).