ahujasid/blender-mcp

BlenderMCP is a bridge between Blender, the open-source 3D modelling program, and Claude AI through the Model Context Protocol. Once installed, you can ask Claude in plain language to build and edit 3D scenes inside Blender, creating objects, changing materials and colours, inspecting what is already in the scene, and even running custom Python code in Blender, instead of clicking through Blender's menus yourself. The system has two parts that talk to each other over a socket. A Blender add-on (addon.py) runs inside Blender and exposes a small server that receives commands. A separate MCP server (the Python package blender-mcp) implements the Model Context Protocol so that Claude can call those commands as tools. You install the add-on through Blender's preferences, then point Claude for Desktop, Claude Code, Cursor, or Visual Studio Code at the MCP server by editing a configuration file. The connection itself is started from a "BlenderMCP" panel in Blender's 3D view sidebar. The host and port the add-on listens on can be set with the BLENDER_HOST and BLENDER_PORT environment variables. Beyond direct scene editing, the integration can pull free assets from Poly Haven through its API, search and download models from Sketchfab, generate new 3D models with Hyper3D Rodin or Hunyuan3D, and capture viewport screenshots so Claude can see what the scene currently looks like. Example prompts in the README include making a low-poly dungeon with a dragon, recreating a beach scene from HDRIs and Poly Haven assets, or turning a reference image into a Blender scene. The project needs Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. It is written in Python.