BlenderMCP is an open-source Model Context Protocol integration that enables Claude AI and other large language models to directly control and interact with Blender, the 3D modeling software. The project bridges the gap between AI assistants and 3D creation tools by implementing a socket-based communication system that allows Claude to execute commands within Blender, fundamentally changing how users can approach 3D modeling and scene creation through natural language prompts.
The repository consists of two primary components working in tandem. The Blender addon, implemented in addon.py, creates a socket server that runs within Blender itself to receive and execute incoming commands. The MCP server, located in src/blender_mcp/server.py, implements the Model Context Protocol specification and handles the connection between Claude and the Blender addon. This two-way communication architecture allows users to describe what they want to create in natural language, and Claude translates those requests into Blender operations.
The feature set is comprehensive for AI-assisted 3D modeling. Users can create, modify, and delete 3D objects through Claude's interface, apply and modify materials and colors, inspect detailed scene information, and execute arbitrary Python code directly in Blender. The integration extends beyond basic modeling by supporting external asset sources including Poly Haven for HDRIs and models, Sketchfab for downloadable models, and AI-generated 3D model generation through Hyper3D Rodin and Hunyuan3D. The addon also includes viewport screenshot capabilities to help Claude better understand the current scene state.
Installation requires Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. The repository provides detailed setup instructions for multiple platforms and MCP clients including Claude Desktop, Cursor, Visual Studio Code, and OpenCode. Configuration involves downloading the addon.py file, installing it through Blender's preferences, and configuring the MCP server connection in the respective client's settings. The system supports environment variable configuration for the Blender socket connection through BLENDER_HOST and BLENDER_PORT parameters.
According to GitGenius activity tracking, the repository shows active maintenance with a median issue and pull request response latency of 9.2 hours across 132 tracked items, though the mean response time of 183.3 hours indicates some variance in response patterns. The primary maintainer ahujasid has logged 165 events, with secondary contributors JohnYeung-dojjy and Eddie11999 contributing 10 and 6 events respectively. The repository's contributor overlap with major projects including microsoft/vscode, microsoft/typescript, and rust-lang/rust suggests it draws from experienced open-source developers.
The project supports persistent API credentials through Blender's addon preferences system, allowing users to store Sketchfab API keys, Hyper3D API keys, and Hunyuan3D credentials that survive Blender restarts. For headless or continuous integration setups, credentials can be injected via environment variables. The system includes telemetry for tool execution that is completely anonymous, and supports remote host deployment for distributed workflows.
The repository is actively developed with recent additions including Hunyuan3D support and expanded asset integration capabilities. The project maintains an official website at blendermcp.org, provides video tutorials for setup and usage, and hosts a Discord community for feedback and collaboration. The implementation demonstrates practical AI-assisted 3D modeling through examples like creating low-poly dungeon scenes, beach environments with procedural assets, and generating models from reference images.
