Blender MCP

Name: Blender MCP
Author: ahujasid

Caution

MCP server for working with Blender

by ahujasid 17,767 MIT Python Intermediate stdio

Install

Claude Code

claude mcp add blender-mcp -- uvx blender-mcp

Cursor

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

VS Code

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

Windsurf

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

Claude Desktop

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

Safety Report

57% Caution

Scanned yesterday

4 passed 3 warnings

Security

Authentication

details

No authentication on the local Blender socket connection; relies on localhost-only binding

Warning

CORS Policy

details

Local socket-based communication; CORS not applicable

N/A

Rate Limiting

details

No rate limiting documented; arbitrary code execution possible at any frequency

Warning

Known CVEs

details

No known CVEs; community project with moderate adoption

Info

Code Quality

Dependency Audit

details

Depends on Blender's Python environment and external APIs (Poly Haven, Sketchfab, Hyper3D); no dependency audit published

Warning

Dangerous Patterns

details

No dangerous code patterns detected

Pass

License

details

MIT License

Pass

Code Source

details

Open source on GitHub (ahujasid/blender-mcp)

Pass

Community

Maintenance Status

details

Actively maintained; popular community project with regular updates

Pass

Learn about our security methodology →

Compatibility

Claude CodePrimary use case is with Claude Desktop/Code via stdio transport

Tested

CursorCursor configuration documented in README

Tested

VS CodeShould work via MCP stdio config; not explicitly documented

Partial

WindsurfShould work via MCP stdio config; not explicitly documented

Partial

Claude DesktopClaude Desktop is the primary documented integration target

Tested

Tools Provided (22)

get_scene_info

Retrieves comprehensive details about the current Blender scene including objects, materials, and scene settings.

get_object_info

Obtains detailed data about a specified object within the Blender scene, including transforms, materials, and mesh data.

get_viewport_screenshot

Captures an image of the Blender 3D viewport with configurable maximum dimensions for visual inspection of the current scene.

execute_blender_code

Runs arbitrary Python code within Blender. Powerful but potentially dangerous — executes in incremental steps. Always save your work before use.

get_polyhaven_categories

Lists available asset categories (HDRIs, textures, models) on the Poly Haven platform.

search_polyhaven_assets

Searches for free assets on Poly Haven with optional filtering by type and category.

download_polyhaven_asset

Downloads and imports a Poly Haven asset (texture, HDRI, or 3D model) directly into the active Blender scene.

set_texture

Applies a previously downloaded Poly Haven texture to a specified object in the Blender scene.

get_polyhaven_status

Checks whether the Poly Haven integration is active and available in the current Blender setup.

get_hyper3d_status

Checks if the Hyper3D Rodin AI model generation integration is accessible.

get_sketchfab_status

Determines whether Sketchfab 3D model library integration is enabled.

search_sketchfab_models

Searches Sketchfab's library for 3D models with optional filtering by keywords and categories.

get_sketchfab_model_preview

Retrieves a thumbnail preview image of a specific Sketchfab model before downloading.

download_sketchfab_model

Downloads and imports a Sketchfab 3D model into the Blender scene with automatic size normalization.

generate_hyper3d_model_via_text

Generates a 3D asset from a textual description using the Hyper3D Rodin AI generation service.

generate_hyper3d_model_via_images

Creates a 3D asset from one or more reference images using the Hyper3D Rodin AI generation service.

poll_rodin_job_status

Monitors the completion status of an ongoing Hyper3D Rodin 3D generation job.

import_generated_asset

Imports a completed Hyper3D-generated 3D model into the active Blender scene.

get_hunyuan3d_status

Checks if the Hunyuan3D local AI model generation integration is available.

generate_hunyuan3d_model

Generates a 3D asset via text prompt or reference image using the local Hunyuan3D model.

poll_hunyuan_job_status

Monitors the completion status of an ongoing Hunyuan3D generation job.

import_generated_asset_hunyuan

Imports a completed Hunyuan3D-generated model into the active Blender scene.

Frequently Asked Questions

What is Blender MCP?

MCP server for working with Blender

What tools does Blender MCP provide?

Blender MCP provides 22 tools including get_scene_info, get_object_info, get_viewport_screenshot, execute_blender_code. Each tool can be called by AI agents to perform specific operations.

Is Blender MCP safe to use?

Blender MCP is rated Caution. Some security checks raised warnings. Review the safety report on this page for details before use.

What are alternatives to Blender MCP?

Similar MCP servers include Davinci Resolve MCP, Manim MCP Server, OpenBrand. Each serves a similar purpose but may differ in features, language, and compatibility.