ClaudeKit Blender

You can extend Blender with ClaudeKit by running a dedicated MCP server that lets Claude Desktop control Blender through a structured toolset. It exposes core Blender actions plus asset integration, scene management, and viewport operations, enabling end-to-end automation from your Claude workflow.

How to use

You connect to the Blender MCP server from your MCP client (Claude Desktop) and start issuing capabilities such as creating objects, modifying scenes, rendering, and importing assets. Start simple: verify the 26 Blender tools are available, then try small tasks like creating a cube, listing objects, and taking a viewport screenshot. You can orchestrate complex workflows by combining object creation, material setup, and asset imports into a single sequence that your Claude prompts drive.

How to install

# Option 1: Global Installation (Production Use)
npm install -g claudekit-blender-mcp

# Option 2: Local Development
# Clone the repository
git clone https://github.com/yourusername/claudekit-blender-mcp.git
cd claudekit-blender-mcp

# Install dependencies
npm install

# Build the project
npm run build

Additional configuration and usage notes

Step 1: Install Blender Addon Open Blender and navigate to Edit → Preferences → Add-ons. Click Install..., then select blender-addon/addon.py. Enable the addon by checking the box labeled "Blender MCP Server". The addon will automatically start the WebSocket server when Blender launches.

Step 2: Configure Claude Desktop The configuration file location depends on your operating system.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "blender": {
      "command": "npx",
      "args": ["-y", "claudekit-blender-mcp"]
    }
  }
}

Local development configuration for Node-based setups

If you build and run locally, you can point Claude Desktop to the built index file using your Node.js path.

{
  "mcpServers": {
    "blender": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/claudekit-blender-mcp/dist/index.js"]
    }
  }
}

Restart Claude Desktop

After making changes to the configuration, fully restart Claude Desktop to apply the new MCP server settings.

# macOS
killall "Claude" && sleep 2 && open -a "Claude"

# Windows
# Close Claude Desktop completely from system tray, then reopen

# Linux
killall claude && claude

Troubleshooting

If the MCP server cannot connect, verify the Blender MCP server is running and the addon is loaded. Check the Blender console for the message indicating the MCP server started on localhost:9876. If you see a spawn node ENOENT error, provide the absolute path to Node.js in your Claude Desktop configuration.

Notes on development and testing

Ensure your Node.js version is compatible (>= 18.0.0). Run builds and keep an eye on Claude Desktop logs for MCP-related messages. When testing, restart Claude Desktop after any changes to the MCP configuration to confirm the new settings are active.

Security and best practices

Only enable the Blender MCP Server on trusted machines and ensure local connections to localhost are allowed. Avoid exposing the MCP server on public networks. Regularly update Blender, Claude Desktop, and the MCP components to benefit from security fixes and new tools.

Examples of workflows

Creating a simple scene: create a cube, add a sphere above it, create a camera, add a sun light, and take a screenshot of the viewport.

What you get with the Blender MCP server

The server exposes 26 Blender tools for object management, scene control, and asset integration, plus tools for viewport capture and Python scripting. It supports core Blender operations like creating and transforming objects, rendering scenes, importing assets, and managing materials and textures.

Support and contributions

If you run into issues, check the logs from Claude Desktop, review Blender console output, and verify the MCP server configuration. Contributions are welcome to extend tool coverage and asset integrations.

Available tools

blender_execute_python

Execute Python code in Blender

blender_create_object

Create objects (cube, sphere, etc.)

blender_list_objects

List all objects in scene

blender_modify_object

Modify object properties

blender_delete_object

Delete objects

blender_get_scene_info

Get scene information

blender_render_scene

Render the current scene

blender_save_file

Save .blend file

blender_take_screenshot

Capture viewport

blender_import_file

Import 3D files

polyhaven_search_assets

Search Poly Haven library for assets

polyhaven_get_asset_info

Get asset details from Poly Haven

polyhaven_download_asset

Download assets from Poly Haven