Blender MCP
MCP for Blender
An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender
Install
claude mcp add blender uvx blender-mcpThis is third-party code. Review the repository files before installing.
What it does
The project has two parts: an addon that opens a socket server inside Blender and an MCP server that connects it to the agent. The agent reads scene info, creates, edits and deletes objects, and sets materials and colors. It can run arbitrary Python in Blender, fetch Poly Haven assets and Sketchfab and Poly Pizza models, and generate 3D models via Hyper3D Rodin and Hunyuan3D. A safe mode validates scripts before they run.
Who it is for. For 3D artists, designers and game developers who want to build Blender scenes from text prompts.
Good fit when
- You need a quick scene or environment prototype
- You need bulk changes to objects or materials via Python
- You want to find and place ready assets from open libraries
Not a fit when
- You need precise manual modeling
- The agent must not run arbitrary code on your machine
Example request
Create a low-poly scene in Blender with a cabin by a lake and sunset lightingLimitations
Requires Blender 3.0+, Python 3.10+ and uv. Only one MCP server instance should run at a time. Telemetry is on by default and can be disabled in addon preferences or with DISABLE_TELEMETRY. Hyper3D, Hunyuan3D and Sketchfab features depend on external services and their keys.
How to disable. Disable the addon in Edit, Preferences, Add-ons and remove the blender server from your MCP client config.
MCP
- Transport
- stdio
- Authentication
- not required
| Environment variables | |
|---|---|
| BLENDER_HOST | Blender socket server host, localhost by default |
| BLENDER_PORT | Blender socket server port, 9876 by default |
| BLENDER_MCP_SAFE_MODE | Set to 1 to validate scripts before they run |
| DISABLE_TELEMETRY | Set to true to fully disable telemetry |
Security check
- Runs arbitrary Python code in Blender
- Telemetry is on by default
README in short
The README gives a four-step quick start: install uv, add the server to your client, install the addon and start the server from the Blender panel. It has configs for Claude Desktop, Claude Code, Codex, Cursor, VS Code, OpenCode and Antigravity. It covers features, env vars, Docker, troubleshooting, security limits and telemetry control. MIT licensed.
FAQ
Is this an official Blender project?
No, the README states it is a third-party integration.
How do I validate code before it runs?
Set BLENDER_MCP_SAFE_MODE=1 so scripts are validated before running in Blender.
Related
Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks
Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering
Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render
An HTML design skill: clickable prototypes, slides with PPTX export, MP4 and GIF animations, infographics and expert review