AugmentClaude
OfficialMCP server · stdio

🧊Blender

By Blender Foundation

Control Blender from Claude in plain English — analyze scenes, run Python, inspect objects, and render.

What it does

The official Model Context Protocol server from the Blender Foundation (Blender Lab). A deliberately small, maintainable bridge between Claude and a running Blender session.

What it gives Claude:

  • Analyze the scene — collection hierarchy, object summaries, polygon outliers
  • Inspect the .blend file — datablock counts, missing files, linked libraries, save status
  • Read Blender's Python API docs and user manual on demand
  • Run Python (bpy) inside Blender, or in a background process
  • Take viewport / window screenshots and render thumbnails or full frames
  • Jump the viewport to objects and switch workspace tabs

How it's wired (two pieces):

  1. A Blender add-on that runs inside Blender and executes requests.
  2. The MCP server (blender-mcp), launched by Claude, which relays requests to the add-on over a local TCP socket.

⚠️ Security: the server executes LLM-generated Python in Blender with no guardrails — it can delete data or reach the network. The Foundation recommends running it on a machine (or VM) without sensitive data.

This is the first-party tool. The community favorite, ahujasid/blender-mcp (~22k stars, MIT), is a separate project with Poly Haven / Sketchfab asset support if you want that instead.

Installation

Before you start

Requires Blender 5.1 or newer. Three pieces must be set up — about 5 minutes.

Step 1 — Install the Blender add-on

  1. Open the official MCP Server page.
  2. Drag and drop the add-on into your open Blender window. You do this twice: first to add the Blender Lab repository, then again to install the add-on itself (this way you also get update notifications). No drag-and-drop? Download it and use Edit → Preferences → Add-ons → Install from Disk.

Step 2 — Enable it and start the server inside Blender

  1. In Edit → Preferences → Add-ons, find MCP and tick its checkbox to enable it.
  2. Open the add-on's preferences panel and click Start (or turn on Auto-start). This opens the TCP socket Claude connects to.

Step 3 — Install the MCP server so the blender-mcp command exists

The server isn't on PyPI yet — install it from source:

git clone https://projects.blender.org/lab/blender_mcp.git && pip install ./blender_mcp/mcp

(Clients that support .mcpb bundles can instead grab the bundle from the repo's release page.)

Step 4 — Connect Claude

Run the install command below. Then just tell Claude what to do in your scene.

  1. Make sure Claude is on your device and in your terminal.

    MCP servers register with Claude Code via claude mcp add. You need Claude Code installed first:

    npm i -g @anthropic-ai/claude-code
  2. Set up the server on your machine.
    Setup
    Sign up to copy
    Sign up free to reveal

    Runs the project's installer (clone + dependencies + config). Follow any prompts. After this finishes, the server is ready to register with Claude Code in the next step.

  3. Restart Claude Code.

    Quit and reopen Claude Code so it picks up the new MCP registration. Run /mcp inside Claude Code to confirm the server is connected.

  4. Use it.

    Ask Claude naturally. It will call the server's tools when your request matches one. Tool calls show up inline so you can see exactly what Claude is doing.

Prefer to read the source first? Open on GitHub.