Blender MCP Server

Content

Blender MCP Server connects Claude to Blender through a local MCP server and a Blender add-on. The add-on opens a socket inside Blender, while the Python MCP server exposes tools Claude can use to inspect the current scene, manipulate objects and materials, run Blender Python, capture viewport screenshots, and coordinate optional asset or 3D-generation workflows.

The project is popular because it turns Blender into an interactive creative workspace for agent-assisted 3D work. Claude can ask for scene information, create or modify objects, update materials, position cameras, download Poly Haven or Sketchfab assets, and work with Hyper3D or Hunyuan3D generation when those integrations are enabled.

Source Review

• https://github.com/ahujasid/blender-mcp
• https://github.com/ahujasid/blender-mcp/blob/main/README.md
• https://github.com/ahujasid/blender-mcp/blob/main/pyproject.toml
• https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py
• https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/telemetry.py
• https://github.com/ahujasid/blender-mcp/blob/main/addon.py
• https://github.com/ahujasid/blender-mcp/blob/main/TERMS_AND_CONDITIONS.md
• https://github.com/ahujasid/blender-mcp/blob/main/LICENSE
• https://pypi.org/project/blender-mcp/

These sources were reviewed on 2026-06-06. Prefer the live repository, README, package metadata, server implementation, add-on source, telemetry code, terms, and PyPI page for current setup steps, tool behavior, telemetry controls, and third-party integration details.

Features

• Local Blender add-on plus Python MCP server architecture.
• Claude Code, Claude Desktop, Cursor, VS Code, and OpenCode configuration examples.
• Scene inspection for objects, materials, cameras, and Blender state.
• Object creation, editing, deletion, material assignment, and texture workflows.
• Viewport screenshot capture so Claude can reason about the visible scene.
• Arbitrary Blender Python execution through execute_blender_code.
• Optional Poly Haven asset search and download support.
• Optional Sketchfab model search, preview, and download support.
• Optional Hyper3D Rodin and Hunyuan3D generation/import workflows.
• Environment variables for Blender socket host and port configuration.
• Telemetry opt-out controls through add-on preferences and environment variables.

Installation

Install uv first if it is not already available, then add the MCP server to Claude Code:

claude mcp add blender uvx blender-mcp

For MCP clients that use JSON configuration:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"]
    }
  }
}

To disable telemetry from the MCP server command, include the environment variable documented by the project:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"],
      "env": {
        "DISABLE_TELEMETRY": "true"
      }
    }
  }
}

Download addon.py from the repository, install it in Blender through Preferences > Add-ons, enable the Blender MCP add-on, and click the add-on's connect button from Blender's 3D View sidebar before using the MCP tools.

Use Cases

• Ask Claude to inspect a scene and summarize objects, materials, and camera state.
• Prototype simple 3D scenes, props, layouts, and material changes from text prompts.
• Generate and review Blender Python before allowing it to run in the active scene.
• Capture a viewport screenshot so Claude can adjust composition or object placement.
• Search and import public assets or HDRIs when Poly Haven or Sketchfab workflows are enabled.
• Generate rough 3D assets through Hyper3D or Hunyuan3D integrations for early concept work.
• Use Claude as a scene assistant while keeping Blender as the local creative environment.

Safety and Privacy

Blender MCP is powerful because it gives Claude direct control over a local creative application. Treat it as an execution-capable local tool, not a passive documentation server. Review generated Python, keep backups of important projects, and avoid running it against sensitive production assets without a clear review step.

Telemetry deserves special attention. The README and telemetry source document ways to disable collection, while the project terms describe possible collection and use of prompts, generated code, scene metadata, and screenshots or viewport images when telemetry is enabled. Disable telemetry and review the current terms before using Blender MCP on confidential client scenes, unreleased models, or work that cannot be used for training or shared research datasets.

Duplicate Check

No ahujasid/blender-mcp, blender-mcp, Blender socket add-on MCP, Poly Haven Blender MCP, Sketchfab Blender MCP, Hyper3D Blender MCP, or Hunyuan3D Blender MCP entry was found in content/mcp, content/tools, content/guides, content/agents, or content/skills.