BlenderMCP logo

BlenderMCP

by ahujasid

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

View on GitHub

Last updated: N/A

What is BlenderMCP?

BlenderMCP is an integration that connects Blender, a 3D creation suite, to Claude AI through the Model Context Protocol (MCP). This allows users to control Blender using natural language prompts via Claude.

How to use BlenderMCP?

To use BlenderMCP, install the Blender addon and configure Claude AI with the provided JSON configuration. Start the Blender addon server, and then interact with Blender through Claude using natural language commands. Refer to the installation and usage sections in the README for detailed steps.

Key features of BlenderMCP

  • Two-way communication between Claude AI and Blender

  • Object manipulation (create, modify, delete)

  • Material control (apply and modify materials and colors)

  • Scene inspection (get detailed scene information)

  • Code execution (run Python code in Blender from Claude)

Use cases of BlenderMCP

  • Prompt-assisted 3D modeling and scene creation

  • Automated object manipulation and material application

  • AI-driven scene inspection and analysis

  • Generating 3D models using Hyper3D Rodin

  • Creating scenes using assets from Poly Haven

FAQ from BlenderMCP

What are the prerequisites for using BlenderMCP?

Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager.

How do I install the Blender addon?

Download the addon.py file, open Blender, go to Edit > Preferences > Add-ons, click 'Install...', and select the addon.py file. Enable the addon by checking the box next to 'Interface: Blender MCP'.

How do I configure Claude for Desktop integration?

Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json and include the provided JSON configuration.

What do I do if I encounter 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. Try restarting both Claude and the Blender server.

What are the limitations and security considerations?

The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous. Use with caution. Complex operations might need to be broken down into smaller steps.