ahujasid/blender-mcp
View on GitHub ↗Community plugin to control Blender 3D with any LLM of your choice
25,968 ★2,473 forksPythonUpdated 19d ago
What you need to know
Socket-based MCP server that connects Blender 3D to any LLM (Claude, Cursor, etc.) for prompt-assisted 3D modeling, scene creation, and manipulation.
Install
uvx blender-mcp uvx blender-mcp install-addon
Usage
- •Install uv first using its official installer (not pip install uv), then configure your MCP client with 'uvx blender-mcp'.
- •Install the addon (uvx blender-mcp install-addon), enable 'Interface: Blender MCP' in Blender Preferences, then press N and click Start MCP Server in the BlenderMCP tab.
- •Only run one instance of the server (either Cursor or Claude Desktop), not both.
- •For AI-generated or downloaded assets, store Sketchfab/Hyper3D/Hunyuan3D credentials in the Blender addon preferences or env vars.
Key features
- ✓Two-way communication via a socket-based JSON protocol between the Blender addon and the MCP server.
- ✓Create, modify and delete 3D objects; apply materials; inspect scenes; execute arbitrary Python code in Blender.
- ✓Poly Haven assets/HDRIs, Sketchfab model search, and AI-generated 3D models via Hyper3D Rodin and Hunyuan3D.
- ✓Persistent API credentials via Blender Add-on Preferences or environment variables.
- ✓Anonymous usage telemetry on by default; disable with DISABLE_TELEMETRY=true.
Best for
Prompt-driven 3D modeling and scene building inside Blender with Claude or other MCP clients.
Caveats
- ⚠execute_blender_code runs arbitrary Python in Blender and is dangerous in production; always save work before using it.
- ⚠Telemetry is on by default and may be used for research and AI model training (opt out via env var or the addon checkbox).
- ⚠Requires Blender 3.0+, Python 3.10+, and uv; GUI-launched clients may fail with 'spawn uvx ENOENT' unless uvx's full path is set.
- ⚠Third-party integration, not made by Blender.
Platforms: macOS · Linux · WindowsClients: Claude Desktop · Claude Code · Cursor · VS Code · OpenCode
Reviewed 2026-08-18
Topics
- Stars
- 25,968★
- Forks
- 2,473
- Language
- Python
- License
- MIT
- Created
- 2025-03-07
- Last push
- 2026-08-16