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

3d-modelingaiblenderblender-addonclaudegenerative-aillmmcpmodel-context-protocolpython
Stars
25,968★
Forks
2,473
Language
Python
License
MIT
Created
2025-03-07
Last push
2026-08-16