Claude × Blender MCP Guide: Creating 3D Models with Natural Language
This guide is for people who have dabbled in Blender but keep getting stuck on modifier settings, or who have zero 3D knowledge but want to build a prototype. It covers the steps to connect Claude Desktop and Blender via Model Context Protocol (MCP). Once connected, simply typing "arrange 5 red cubes randomly" in the chat will cause Claude to generate objects directly inside Blender. Based on the official repository ahujasid/blender-mcp, this article walks through (1) installing the Blender add-on, (2) registering the MCP server in Claude Desktop, and (3) verifying the connection and troubleshooting.
What makes this exciting is that simply typing "arrange 5 red cubes randomly" causes Claude to generate objects directly inside Blender. Beyond that, you can fetch textures from Poly Haven, generate 3D meshes from images via Hyper3D, and even run arbitrary Python — all from the chat interface.
This guide targets people who want to prototype 3D ideas without any prior 3D knowledge, as well as intermediate Blender users looking to speed up repetitive tasks. All you need is Blender 3.0 or later, Claude Desktop, and uv — the steps below are based on the official repository ahujasid/blender-mcp and are designed to get you up and running as quickly as possible.
目次 (7)
What Is Blender MCP?
Blender MCP is an adapter for connecting Anthropic's Claude to Blender. It operates in two layers: a socket server (add-on) that runs persistently inside Blender, and an MCP server (a Python process launched via uvx) that Claude Desktop starts. Natural language requests from Claude are translated into Blender API calls by the MCP server, which the Blender add-on then executes.
According to the official documentation, the tools currently implemented include: object creation, movement, and deletion; material and color settings; scene information retrieval; screenshot capture of the 3D viewport; and arbitrary Python code execution — six tool types in total. Integration with Poly Haven for texture and HDRI retrieval, and Hyper3D Rodin for image-to-3D mesh generation, is also included, allowing textures and backgrounds to be set up entirely through natural language. The same MCP server can be referenced from Cursor or Claude Code, but this article focuses on the most standard setup using Claude Desktop.
Requirements and Preparation
Before getting started, you need three things: (a) Blender 3.0 or later, (b) the latest version of Claude Desktop (macOS / Windows), and (c) the uv package manager. You can install uv with pipx install uv, or on macOS with brew install uv. There is no need to manually set up Python — uvx automatically fetches the required version.
On the network side, the Blender add-on listens on localhost:9876, and the MCP server connects to that port as a client. If local sockets are blocked by a corporate network or antivirus software, the connection will fail — if you encounter issues during the connection verification step described later, this is the first thing to check. If you plan to use Hyper3D for 3D generation or Poly Haven for asset retrieval, outbound HTTPS access is also required.
Step 1: Installing the Blender Add-on
Install the Blender add-on in the following order.
- Download
addon.pydirectly from the GitHub repositoryahujasid/blender-mcp(cloning the repo is also fine) - Launch Blender, go to
Edit→Preferences→Add-ons→Install..., and select the savedaddon.py - Enable the add-on by checking the box next to "Interface: Blender MCP" in the list
- Press
Nin the 3D viewport to open the sidebar, then open the newly appearedBlenderMCPtab - Optionally check
Use assets from Poly Havenand/orUse Hyper3D Rodin 3D model generation - Click the
Connect to Claudebutton (the Claude side does not need to be configured yet at this point — the add-on will open the port and wait)
The Blender side is now ready. If the BlenderMCP tab does not appear in the sidebar, the most likely causes are that the add-on's enable checkbox is unchecked, or that the Blender version is older than 3.0.
Step 2: Registering the MCP Server in Claude Desktop
On the Claude Desktop side, write the MCP server launch command into the configuration file claude_desktop_config.json. On macOS it is located at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows at %APPDATA%\Claude\claude_desktop_config.json (create the file if it does not exist).
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}
After saving, fully quit Claude Desktop and restart it. On some operating systems, simply closing the window via the × button does not cause the MCP server to reload. To be safe, confirm in Task Manager (or Activity Monitor on macOS) that the Claude process has completely exited before restarting.
Step 3: Verifying the Connection and Sending Your First Prompt
After restarting Claude Desktop, a hammer icon will appear at the bottom right of the input field, showing a list of available MCP tools. If get_scene_info, create_object, set_material, and other tools appear under the blender group, the MCP server itself is running correctly.
If you have also clicked Connect to Claude in Blender's BlenderMCP tab, you are ready to send your first prompt. The fastest way to verify the connection is to type "Tell me about the current scene." Claude will call get_scene_info and return information about the default Cube, Camera, and Light — if it does, the connection is established. Next, try an instruction like "Place a red sphere at the origin, then arrange 5 blue cubes with a radius of 0.3 in a circle above it," and you should see objects appear in the Blender viewport in real time.
Overview of What You Can Do
After connecting, the operations you can request from Claude fall into four broad categories.
- Scene operations: Adding, deleting, moving, rotating, and scaling objects; assigning materials; retrieving scene information
- Environment setup: Downloading HDRIs (high dynamic range images capturing the full surrounding environment, used to provide background and natural ambient lighting) and textures from Poly Haven and applying them to the scene; configuring lighting
- 3D generation: Passing images or text to Hyper3D Rodin to generate meshes, then importing them into Blender
- Script execution: Running arbitrary Python code inside Blender to delegate tasks not covered by the add-on's built-in tools, such as adding modifiers or manipulating geometry nodes. Modifiers are features that apply effects like deformation or duplication non-destructively on top of the original shape; geometry nodes refer to a system that procedurally generates geometry by connecting nodes with wires.
Python execution in particular is powerful. Tasks that would take an experienced Blender user several dozen seconds — such as "Add a two-level Subdivision Surface (a modifier that subdivides faces to approximate a smooth curved surface) to all selected objects and apply Shade Smooth (a setting that renders shading across face boundaries smoothly)" — can be completed with a single prompt. On the flip side, because Python is running, a poorly reviewed script could accidentally destroy your scene, so make sure to save important files before proceeding.
Note that Python execution, modifiers, and geometry node operations are primarily suited for intermediate users who already have a solid grasp of Blender basics. If you are completely new to 3D, start with what is covered up through Step 3 — generating and placing objects with natural language — and gradually add more advanced instructions to your prompts as you need them.
Sources and References
- Blender MCP Official Repository (ahujasid/blender-mcp)
- Blender MCP Introduction Site (blender-mcp.com)
- "Can AI Really Create 3D Content with Blender MCP? The Results of Connecting It to Claude Desktop Were Incredible" (poniblog.com)
- "How to Create 3D Models with AI by Connecting Claude and Blender" (saru-blender.com)
- "Trying Out Laptop Modeling with Claude and the Blender MCP Server" (crossroad-tech.com)
- "Trying Out Blender MCP" (engineerblog.mynavi.jp)
