BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation. We have no official website. Any website you see online is unofficial and has no affiliation with this project. Use them at your own risk. Full tutorial Give feedback
Add this skill
npx mdskills install ahujasid/blender-mcpEnables Claude to control Blender for 3D modeling with comprehensive setup docs and useful integrations
123# BlenderMCP - Blender Model Context Protocol Integration45BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.67**We have no official website. Any website you see online is unofficial and has no affiliation with this project. Use them at your own risk.**89[Full tutorial](https://www.youtube.com/watch?v=lCyQ717DuzQ)1011### Join the Community1213Give feedback, get inspired, and build on top of the MCP: [Discord](https://discord.gg/z5apgR8TFU)1415### Supporters1617[CodeRabbit](https://www.coderabbit.ai/)1819**All supporters:**2021[Support this project](https://github.com/sponsors/ahujasid)2223## Current version(1.5.5)24- Added Hunyuan3D support25- View screenshots for Blender viewport to better understand the scene26- Search and download Sketchfab models27- Support for Poly Haven assets through their API28- Support to generate 3D models using Hyper3D Rodin29- Run Blender MCP on a remote host30- Telemetry for tools executed (completely anonymous)3132### Installating a new version (existing users)33- For newcomers, you can go straight to Installation. For existing users, see the points below34- Download the latest addon.py file and replace the older one, then add it to Blender35- Delete the MCP server from Claude and add it back again, and you should be good to go!363738## Features3940- **Two-way communication**: Connect Claude AI to Blender through a socket-based server41- **Object manipulation**: Create, modify, and delete 3D objects in Blender42- **Material control**: Apply and modify materials and colors43- **Scene inspection**: Get detailed information about the current Blender scene44- **Code execution**: Run arbitrary Python code in Blender from Claude4546## Components4748The system consists of two main components:49501. **Blender Addon (`addon.py`)**: A Blender addon that creates a socket server within Blender to receive and execute commands512. **MCP Server (`src/blender_mcp/server.py`)**: A Python server that implements the Model Context Protocol and connects to the Blender addon5253## Installation545556### Prerequisites5758- Blender 3.0 or newer59- Python 3.10 or newer60- uv package manager:6162**If you're on Mac, please install uv as**63```bash64brew install uv65```66**On Windows**67```powershell68powershell -c "irm https://astral.sh/uv/install.ps1 | iex"69```70and then add uv to the user path in Windows (you may need to restart Claude Desktop after):71```powershell72$localBin = "$env:USERPROFILE\.local\bin"73$userPath = [Environment]::GetEnvironmentVariable("Path", "User")74[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")75```7677Otherwise installation instructions are on their website: [Install uv](https://docs.astral.sh/uv/getting-started/installation/)7879**⚠️ Do not proceed before installing UV**8081### Environment Variables8283The following environment variables can be used to configure the Blender connection:8485- `BLENDER_HOST`: Host address for Blender socket server (default: "localhost")86- `BLENDER_PORT`: Port number for Blender socket server (default: 9876)8788Example:89```bash90export BLENDER_HOST='host.docker.internal'91export BLENDER_PORT=987692```9394### Claude for Desktop Integration9596[Watch the setup instruction video](https://www.youtube.com/watch?v=neoK_WMq92g) (Assuming you have already installed uv)9798Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:99100```json101{102 "mcpServers": {103 "blender": {104 "command": "uvx",105 "args": [106 "blender-mcp"107 ]108 }109 }110}111```112<details>113<summary>Claude Code</summary>114115Use the Claude Code CLI to add the blender MCP server:116117```bash118claude mcp add blender uvx blender-mcp119```120</details>121122### Cursor integration123124[](https://cursor.com/link/mcp%2Finstall?name=blender&config=eyJjb21tYW5kIjoidXZ4IGJsZW5kZXItbWNwIn0%3D)125126For Mac users, go to Settings > MCP and paste the following127128- To use as a global server, use "add new global MCP server" button and paste129- To use as a project specific server, create `.cursor/mcp.json` in the root of the project and paste130131132```json133{134 "mcpServers": {135 "blender": {136 "command": "uvx",137 "args": [138 "blender-mcp"139 ]140 }141 }142}143```144145For Windows users, go to Settings > MCP > Add Server, add a new server with the following settings:146147```json148{149 "mcpServers": {150 "blender": {151 "command": "cmd",152 "args": [153 "/c",154 "uvx",155 "blender-mcp"156 ]157 }158 }159}160```161162[Cursor setup video](https://www.youtube.com/watch?v=wgWsJshecac)163164**⚠️ Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both**165166### Visual Studio Code Integration167168_Prerequisites_: Make sure you have [Visual Studio Code](https://code.visualstudio.com/) installed before proceeding.169170[](vscode:mcp/install?%7B%22name%22%3A%22blender-mcp%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22blender-mcp%22%5D%7D)171172### Installing the Blender Addon1731741. Download the `addon.py` file from this repo1751. Open Blender1762. Go to Edit > Preferences > Add-ons1773. Click "Install..." and select the `addon.py` file1784. Enable the addon by checking the box next to "Interface: Blender MCP"179180181## Usage182183### Starting the Connection1841851861. In Blender, go to the 3D View sidebar (press N if not visible)1872. Find the "BlenderMCP" tab1883. Turn on the Poly Haven checkbox if you want assets from their API (optional)1894. Click "Connect to Claude"1905. Make sure the MCP server is running in your terminal191192### Using with Claude193194Once the config file has been set on Claude, and the addon is running on Blender, you will see a hammer icon with tools for the Blender MCP.195196197198#### Capabilities199200- Get scene and object information201- Create, delete and modify shapes202- Apply or create materials for objects203- Execute any Python code in Blender204- Download the right models, assets and HDRIs through [Poly Haven](https://polyhaven.com/)205- AI generated 3D models through [Hyper3D Rodin](https://hyper3d.ai/)206207208### Example Commands209210Here are some examples of what you can ask Claude to do:211212- "Create a low poly scene in a dungeon, with a dragon guarding a pot of gold" [Demo](https://www.youtube.com/watch?v=DqgKuLYUv00)213- "Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven" [Demo](https://www.youtube.com/watch?v=I29rn92gkC4)214- Give a reference image, and create a Blender scene out of it [Demo](https://www.youtube.com/watch?v=FDRb03XPiRo)215- "Generate a 3D model of a garden gnome through Hyper3D"216- "Get information about the current scene, and make a threejs sketch from it" [Demo](https://www.youtube.com/watch?v=jxbNI5L7AH8)217- "Make this car red and metallic"218- "Create a sphere and place it above the cube"219- "Make the lighting like a studio"220- "Point the camera at the scene, and make it isometric"221222## Hyper3D integration223224Hyper3D's free trial key allows you to generate a limited number of models per day. If the daily limit is reached, you can wait for the next day's reset or obtain your own key from hyper3d.ai and fal.ai.225226## Troubleshooting227228- **Connection issues**: Make sure the Blender addon server is running, and the MCP server is configured on Claude, DO NOT run the uvx command in the terminal. Sometimes, the first command won't go through but after that it starts working.229- **Timeout errors**: Try simplifying your requests or breaking them into smaller steps230- **Poly Haven integration**: Claude is sometimes erratic with its behaviour231- **Have you tried turning it off and on again?**: If you're still having connection errors, try restarting both Claude and the Blender server232233234## Technical Details235236### Communication Protocol237238The system uses a simple JSON-based protocol over TCP sockets:239240- **Commands** are sent as JSON objects with a `type` and optional `params`241- **Responses** are JSON objects with a `status` and `result` or `message`242243## Limitations & Security Considerations244245- The `execute_blender_code` tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous. Use with caution in production environments. ALWAYS save your work before using it.246- Poly Haven requires downloading models, textures, and HDRI images. If you do not want to use it, please turn it off in the checkbox in Blender.247- Complex operations might need to be broken down into smaller steps248249250#### Telemetry Control251252BlenderMCP collects anonymous usage data to help improve the tool. You can control telemetry in two ways:2532541. **In Blender**: Go to Edit > Preferences > Add-ons > Blender MCP and uncheck the telemetry consent checkbox255 - With consent (checked): Collects anonymized prompts, code snippets, and screenshots256 - Without consent (unchecked): Only collects minimal anonymous usage data (tool names, success/failure, duration)2572582. **Environment Variable**: Completely disable all telemetry by running:259```bash260DISABLE_TELEMETRY=true uvx blender-mcp261```262263Or add it to your MCP config:264```json265{266 "mcpServers": {267 "blender": {268 "command": "uvx",269 "args": ["blender-mcp"],270 "env": {271 "DISABLE_TELEMETRY": "true"272 }273 }274 }275}276```277278All telemetry data is fully anonymized and used solely to improve BlenderMCP.279280281## Contributing282283Contributions are welcome! Please feel free to submit a Pull Request.284285## Disclaimer286287This is a third-party integration and not made by Blender. Made by [Siddharth](https://x.com/sidahuj)288
Full transparency — inspect the skill content before installing.