Labsco
ahujasid logo

BlenderMCP

★ 23,500

from ahujasid

Connects Blender to Claude AI via the Model Context Protocol (MCP), enabling direct interaction and control for prompt-assisted 3D modeling, scene creation, and manipulation.

🔥🔥🔥🔥✓ VerifiedFreeQuick setup
#browser#devops#git#search#security

BlenderMCP - Blender Model Context Protocol Integration

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.

Official website

Full tutorial

Join the Community

Give feedback, get inspired, and build on top of the MCP: Discord

Supporters

CodeRabbit

All supporters:

Support this project

Highlights

For the current version and changelog, see the releases page.

  • Added Hunyuan3D support

  • View screenshots for Blender viewport to better understand the scene

  • Search and download Sketchfab models

  • Support for Poly Haven assets through their API

  • Support to generate 3D models using Hyper3D Rodin

  • Run Blender MCP on a remote host

  • Telemetry for tools executed (completely anonymous)

Installing a new version (existing users)

  • For newcomers, you can go straight to Installation. For existing users, see the points below

  • Download the latest addon.py file and replace the older one, then add it to Blender

  • Delete the MCP server from Claude and add it back again, and you should be good to go!

Features

  • Two-way communication: Connect Claude AI to Blender through a socket-based server

  • Object manipulation: Create, modify, and delete 3D objects in Blender

  • Material control: Apply and modify materials and colors

  • Scene inspection: Get detailed information about the current Blender scene

  • Code execution: Run arbitrary Python code in Blender from Claude

Components

The system consists of two main components:

  • Blender Addon (addon.py): A Blender addon that creates a socket server within Blender to receive and execute commands

  • MCP Server (src/blender_mcp/server.py): A Python server that implements the Model Context Protocol and connects to the Blender addon

Hyper3D integration

Hyper3D'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.

Persistent API credentials

BlenderMCP supports persistent credentials via Blender Add-on Preferences:

Edit -> Preferences -> Add-ons -> Blender MCP

You can store these values there so they survive Blender restarts:

  • Sketchfab API Key

  • Hyper3D API Key

  • Hunyuan3D SecretId / SecretKey

  • Hunyuan3D API URL

For headless setups or CI, credentials can also be injected by environment variables:

  • BLENDERMCP_SKETCHFAB_API_KEY

  • BLENDERMCP_HYPER3D_API_KEY

  • BLENDERMCP_HUNYUAN3D_SECRET_ID

  • BLENDERMCP_HUNYUAN3D_SECRET_KEY

  • BLENDERMCP_HUNYUAN3D_API_URL

Technical Details

Communication Protocol

The system uses a simple JSON-based protocol over TCP sockets:

  • Commands are sent as JSON objects with a type and optional params

  • Responses are JSON objects with a status and result or message

Limitations & Security Considerations

  • 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.

  • 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.

  • Complex operations might need to be broken down into smaller steps

Telemetry Control

BlenderMCP collects anonymous usage data to help improve the tool. You can control telemetry in two ways:

In Blender: Go to Edit > Preferences > Add-ons > Blender MCP and uncheck the telemetry consent checkbox

  • With consent (checked): Collects anonymized prompts, code snippets, and screenshots

  • Without consent (unchecked): Only collects minimal anonymous usage data (tool names, success/failure, duration)

Environment Variable: Completely disable all telemetry by running:

Copy & paste — that's it
DISABLE_TELEMETRY=true uvx blender-mcp

Or add it to your MCP config:

Copy & paste — that's it
{
 "mcpServers": {
 "blender": {
 "command": "uvx",
 "args": ["blender-mcp"],
 "env": {
 "DISABLE_TELEMETRY": "true"
 }
 }
 }
}

All telemetry data is fully anonymized and used solely to improve BlenderMCP.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This is a third-party integration and not made by Blender. Made by Siddharth