Vi3W
Skip to content

Guides

How to connect Claude to Blender with MCP: the official connector and the community add-on

Blender MCP Claude setup: connect Claude to Blender with the official connector or MCP for Blender, first prompts, safety and fixes.

3 min read

A laptop with a small 3D scene of colourful shapes rising from it on beams of light
Illustration. Once connected, Claude can build and fix scenes in Blender.

Quick answer

How do I connect Claude to Blender?

Install and enable the Blender MCP add-on in Blender, then connect Claude to the MCP server: through Claude's Blender connector (built on the official Blender Lab server) or by adding a server entry to Claude Desktop's config. Start the server inside Blender, restart Claude, and ask it to describe your scene to test.

Two ways to connect Claude to Blender

There are two Blender MCP setups for Claude, and tutorials mix them up:

  1. Claude's Blender connector, launched by Anthropic on April 28, 2026 and built on the official Blender Lab MCP server. Fewer steps, maintained by Blender developers.
  2. MCP for Blender, the community server by Siddharth Ahuja (GitHub). More features (Poly Haven, Sketchfab, Rodin, Hunyuan3D), more setup.

If you're unsure, start with the official one. Background on both: Blender MCP explained.

Video: Set Up Blender MCP in 2 Minutes — Control Blender With Claude, by FromQCWithGameDev (YouTube)

Option 1: the official Blender MCP server with Claude

  1. Install the Blender MCP add-on from the Blender Lab project and enable it in Edit ‣ Preferences ‣ Add-ons. Its preferences have host, port and an auto-start option.
  2. Connect Claude. Enable the Blender connector in Claude, or register the server's blender-mcp command as an MCP server in your client. The client launches it and talks to it over stdio.
  3. Start the server in Blender (or tick auto-start).
  4. Test with a read-only prompt: "Summarise the objects in my scene."

If the add-on won't connect to anything, check Preferences ‣ System ‣ Allow Online Access, and confirm your Blender version is recent enough for the add-on. Third-party write-ups list Blender 5.1 or newer for the official server; check the project page for the current requirement.

Option 2: MCP for Blender with Claude Desktop

From the project's README:

  1. Install uv. macOS: brew install uv. Windows: winget install --id=astral-sh.uv -e. Don't use pip install uv.
  2. Add the server to Claude Desktop. Settings ‣ Developer ‣ Edit Config, then add a server named blender with "command": "uvx" and "args": ["mcp-for-blender"] inside mcpServers.
  3. Install the Blender add-on: run uvx mcp-for-blender install-addon, then enable Interface: MCP for Blender in Preferences ‣ Add-ons.
  4. Start it. In the 3D Viewport press N, open the MCP for Blender tab, click Start MCP Server.
  5. Fully restart Claude Desktop, not just close the window.

Optional: tick Poly Haven in the sidebar for free assets; add Sketchfab, Hyper3D or Hunyuan3D keys in the add-on preferences.

Glass chat bubble connected to a 3D scene by light
Illustration. Claude sends tool calls; the add-on runs them inside Blender.

First prompts that work well

Start small, check the screenshot, then build:

  • "List every object, its polygon count and its material."
  • "Apply scale on all selected objects and set their origins to the bottom centre."
  • "Make a low-poly wooden fence of 12 posts along the X axis, 2 m apart."
  • "Find textures that are missing from disk."
  • "Import model.glb from my Downloads folder, scale it to 1.8 m tall, and put it on the floor."

Long, vague prompts ("make me a medieval village") time out or produce code soup. Ask for one part at a time.

Safety

Both servers let Claude run Python inside Blender. Save first. The official project recommends a VM or isolated machine; the community add-on's socket has no authentication, so keep it on localhost. The community add-on also has a safe mode (BLENDER_MCP_SAFE_MODE=1) and opt-out telemetry (DISABLE_TELEMETRY=true).

When it doesn't connect

Run only one client (Claude Desktop or Cursor, not both) against one Blender, restart the client fully after config changes, and check the server is started in Blender. Full checklist: Blender MCP not working.

Give Claude real models to place

Claude in Blender builds well with code and primitives, but detailed organic props are faster to generate. Make them in Vi3W from a prompt, image or sketch, export GLB, and ask Claude to import and arrange them. Try Vi3W.

Frequently asked questions

blender mcp claude free

The MCP servers are free. Whether Claude is free depends on your Claude plan and its usage limits; heavy Blender sessions with many screenshots use more of your allowance.

blender mcp claude code

Claude Code can use the same MCP servers. Add the server with Claude Code's MCP configuration, keep Blender open with the add-on running, and Claude Code can read and edit the scene from your terminal.

blender mcp how to install

Two parts: install the Blender add-on (Edit, Preferences, Add-ons, Install from Disk, or the project's own install command), then register the MCP server in your AI client. Both are covered step by step above.

Last reviewed