Blender

What is Blender?

BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender for prompt-assisted 3D modeling, scene creation, and manipulation.

How to use Blender?

Install prerequisites (Blender 3.0+, Python 3.10+, uv), download the addon.py file and install it in Blender (Edit > Preferences > Add-ons), then configure the MCP server in your client’s config file (Claude Desktop, Cursor, VS Code, etc.). In Blender, open the 3D View sidebar, find the BlenderMCP tab, optionally enable Poly Haven, and click “Connect to Claude”. The server connects via the host and port specified by environment variables BLENDER_HOST (default localhost) and BLENDER_PORT (default 9876).

Key features of Blender

• Two-way communication between Claude AI and Blender via sockets
• Object manipulation: create, modify, and delete 3D objects
• 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
• Support for Poly Haven assets, Sketchfab downloads, and AI‑generated 3D models (Hyper3D Rodin, Hunyuan3D)

Use cases of Blender

• Create a low poly dungeon scene with a dragon guarding treasure
• Build a beach scene using HDRIs, textures, and models from Poly Haven
• Generate a 3D model from a reference image or text prompt
• Modify object materials (e.g., “make this car red and metallic”)
• Point the camera and set isometric views for the scene

FAQ from Blender

What are the system requirements?

Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager (install via brew install uv on macOS, or the official installer on Windows/Linux). On locked‑down machines, pipx can be used as an alternative.

How does communication between Claude and Blender work?

The system uses a simple JSON‑based protocol over TCP sockets. The Blender addon runs a socket server that receives commands; the MCP server implements the Model Context Protocol and sends commands to that socket.

How can I troubleshoot connection issues?

Ensure the Blender addon server is running and the MCP server is configured in your client. Do not run the uvx command manually in the terminal while the client is active. If problems persist, restart both Claude and the Blender server. For timeout errors, try simplifying requests or breaking them into smaller steps.

What security considerations should I be aware of?

The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous. Use with caution.

How do I configure persistent API credentials?

Credentials for Sketchfab, Hyper3D, and Hunyuan3D can be stored in Blender’s Add‑on Preferences (Edit > Preferences > Add‑ons > Blender MCP) so they survive restarts. Alternatively, for headless setups, use environment variables like BLENDERMCP_SKETCHFAB_API_KEY, BLENDERMCP_HYPER3D_API_KEY, etc.