blender-open-mcp

Overview

blender-open-mcp is a Model Context Protocol implementation that enables natural language control of Blender 3D using local AI models. The system consists of three main components: a FastMCP server that exposes tools via HTTP or stdio, a Blender add-on that runs inside Blender as a TCP socket server, and integration with Ollama for local AI model inference. This architecture allows users to control Blender through various MCP clients like Claude or Cursor using natural language prompts, bridging the gap between 3D workflows and AI assistance.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• blender_get_scene_info

  Get full scene summary including objects, camera, and render settings

  Try:What's in the current scene?Try:List all objects in the scene
• blender_create_object

  Add a primitive mesh like cube, sphere, or cylinder to the scene

  Try:Create a red cubeTry:Add a metallic sphere at position 0,0,2
• blender_modify_object

  Change an object's location, rotation, scale, or visibility

  Try:Move cube to position 5,0,0Try:Scale sphere to twice its size
• blender_delete_object

  Remove an object from the scene

  Try:Delete the cubeTry:Remove all named objects
• blender_set_material

  Create and assign a Principled BSDF material to an object

  Try:Make the cube goldTry:Apply a blue material to the sphere
• blender_render_image

  Render the current scene to a file

  Try:Render the scene as PNGTry:Create a high-quality render
• blender_ai_prompt

  Send a natural language prompt to Ollama for AI assistance

  Try:Write code to add a sun lightTry:Help me create a material that looks like water
• blender_download_polyhaven_asset

  Download and import an asset from PolyHaven

  Try:Download a brick wall textureTry:Get a tree model
• blender_set_texture

  Apply a downloaded PolyHaven texture to an object

  Try:Apply brick texture to the wallTry:Use the wood material on the table
• blender_get_ollama_models

  List available local Ollama models

  Try:What models are available?Try:List all Ollama models
• blender_set_ollama_model

  Switch the active Ollama model

  Try:Switch to Gemma3 modelTry:Change model to llama3.2
• blender_execute_code

  Run arbitrary Python/bpy code in Blender

  Try:Run this Python code: bpy.ops...Try:Execute generated bpy script

Comparable tools

Installation

git clone https://github.com/dhakalnirajan/blender-open-mcp.git
cd blender-open-mcp
uv venv
source .venv/bin/activate  # Linux / macOS
# .venv\Scripts\activate    # Windows
uv pip install -e .

ollama pull llama3.2

{
  "mcpServers": {
    "blender-open-mcp": {
      "command": "blender-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

FAQ

How do I connect to Blender add-on?

Open Blender → N-sidebar → Blender MCP → Click 'Start MCP Server' (default port: 9876)

What models are supported with Ollama?

Any model available in Ollama including llama3.2, Gemma3, and others. Use 'blender_get_ollama_models' to see available models.

Compare blender-open-mcp with