home / mcp / blender mcp server

Blender MCP Server

Provides programmatic control of Blender via Claude Desktop, enabling object creation, manipulation, rendering, and scene management.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "gajanm-afterquery_mcp": {
      "command": "python3",
      "args": [
        "/YOUR/PATH/TO/blender_takehome/blender_mcp_filter.py"
      ],
      "env": {
        "PYTHONPATH": "/YOUR/PATH/TO/blender_takehome:/YOUR/PATH/TO/blender_takehome/src"
      }
    }
  }
}

You can run a Blender MCP server that lets Claude Desktop control Blender tools directly from conversation. This setup exposes a set of predefined MCP tools to create and manipulate Blender objects, manage scenes, render, and perform common operations, enabling you to experiment with Blender via natural language commands.

How to use

Connect Claude Desktop to the Blender MCP server to start using Blender tools from conversations. The server runs as a local process and exposes a collection of tools that you can invoke through Claude to create, modify, and render Blender scenes. Start a conversation, ask Claude to perform an action (for example, create a cube, move an object, or render a scene), and Blender will execute the corresponding tool and update the scene.

Before you begin, ensure you have the required software installed and the server configured to launch automatically when Claude Desktop starts a session.

How to install

Prerequisites you need before installing the server are: - Python 3.13 or newer - Blender 5.0 or newer, with the Blender executable path available on your system (macOS example: /Applications/Blender.app/Contents/MacOS/Blender) - Claude Desktop installed for AI agent integration.

Install the server dependencies by navigating to the project directory and installing in editable mode. Run the following commands exactly as shown:

cd /path/to/blender_takehome
pip install -e .

This installs:
- fastmcp>=2.12.4 - MCP server framework
- pydantic>=2.0.0 - Input validation
- fake-bpy-module-latest - Type stubs for development

Additional configuration and usage notes

You configure the Blender MCP server to run as a local process that Claude Desktop will launch. Use the following configuration snippet to define the server. This example assumes you have placed the server script and Blender-related files in your project and you will replace the placeholder paths with your actual locations.

{
  "mcpServers": {
    "blender-mcp": {
      "command": "python3",
      "args": [
        "/YOUR/PATH/TO/blender_takehome/blender_mcp_filter.py"
      ],
      "env": {
        "PYTHONPATH": "/YOUR/PATH/TO/blender_takehome:/YOUR/PATH/TO/blender_takehome/src"
      }
    }
  }
}

Tools and capabilities

The server exposes a set of MCP tools organized by functionality. You can use these tools to create primitives, manipulate objects, manage the scene, configure cameras and lights, render, and perform file operations. Examples include creating a cube, moving or rotating objects, listing objects, creating materials, and rendering the scene.

Available tools

create_cube_tool

Create a cube primitive in the current Blender scene.

create_sphere_tool

Create a UV sphere primitive.

create_cylinder_tool

Create a cylinder primitive.

create_plane_tool

Create a plane primitive.

duplicate_object_tool

Duplicate an existing object.

move_object_tool

Move an object to a new location.

rotate_object_tool

Rotate an object.

scale_object_tool

Scale an object.

delete_object_tool

Delete an object from the scene.

select_object_tool

Select an object in the scene.

list_objects_tool

List all objects in the scene.

get_object_info_tool

Get detailed information about an object.

clear_scene_tool

Remove all objects from the scene.

set_active_camera_tool

Set the active camera for rendering.

create_material_tool

Create a new material with a base color.

assign_material_tool

Assign a material to an object.

create_camera_tool

Create and configure a camera.

create_light_tool

Create a light source.

render_scene_tool

Render the scene to an image file.

get_scene_filepath_tool

Get the current Blender file path.

save_file_tool

Save the scene to a file.

open_file_tool

Open an existing Blender file.