ahujasid/blender-mcp

Project overview

blender-mcp connects Blender to LLM-based AI assistants such as Claude through the Model Context Protocol, enabling prompt-assisted 3D modeling, scene creation, and manipulation via TCP socket communication.

Project type

MCP · Workflow

Use cases

Documents & Office

Deployment

Refer to project documentation

License

MIT

Best for

• Creators and developers looking to automate 3D modeling, scene creation, and object manipulation in Blender via an MCP-compatible AI client.

Key capabilities

• Connects AI clients to Blender through a socket-based server using a JSON-based protocol over TCP.
• Provides the ability to create, modify, and delete 3D objects within the active Blender scene.
• Applies and modifies materials and colors on specified objects in the scene.
• Gets detailed information about the current state of the Blender scene.
• Runs arbitrary Python code in Blender from an AI client to perform operations outside of predefined tool capabilities.
• Provides Blender viewport screenshots to the AI client as visual context for understanding the current scene.
• Supports running Blender MCP on a remote host configuration.
• Adds support for using the third-party Hunyuan3D integration.

Limitations and risks

• Complex operations might need to be broken down into smaller, sequential steps for the AI client to process successfully.
• The execute_blender_code tool allows running arbitrary Python code in Blender, which is potentially dangerous; users should save their work before using it and exercise caution in production environments.

Getting started

• Install the uv package manager, install the addon.py file in Blender, edit the client config to add the uvx blender-mcp command, start the server in a terminal, and click Connect to Claude in Blender.

Evidence and sources

• GitHub project description: Open-source MCP to use Blender with any LLM
• README: - Added Hunyuan3D support - View screenshots for Blender viewport to better understand the scene - Search and download Sketchfab models - Support for Poly Haven assets through the…
• README: - **Two-way communication**: Connect Claude AI to Blender through a socket-based server - **Object manipulation**: Create, modify, and delete 3D objects in Blender - **Material co…
• README: 1. **Blender Addon (`addon.py`)**: A Blender addon that creates a socket server within Blender to receive and execute commands 2. **MCP Server (`src/blender_mcp/server.py`)**: A P…
• README: - Blender 3.0 or newer - Python 3.10 or newer - uv package manager:

Reviewed at: 2026-07-19T18:37:11Z