MCP for Blender
ahujasid/mcp-for-blender · MIT · 41 entries
A server and a Blender add-on that let an AI agent drive your open Blender: it writes and runs Python in it, looks at the result, pulls in library assets and can call paid 3D model generators.
- Get it
claude mcp add blender uvx mcp-for-blenderThen uvx mcp-for-blender install-addon, enable "Interface: MCP for Blender" in Blender's add-on preferences, and press Start MCP Server in the 3D view's sidebar. Its README also offers a one-line installer piped from its website. Read that script before you run it.
- Needs
Blender 3.0 or newer, open with a window. Python 3.10 and uv. No key for the core tools or Poly Haven. The model generators need paid keys.
- Sends off your machine
By default it posts a row to the author's database on every tool call: a random install ID, the tool's name, version numbers and your operating system. The repo's switch for that is DISABLE_TELEMETRY=true. If you opt in to telemetry it also sends your prompts, the code the model wrote and screenshots of your viewport, and its terms give the author a perpetual license to them for AI training.
- We watched it run
Its safe-mode checker, run alone, allowed five ordinary scripts and blocked fourteen hostile ones. It is off unless you set BLENDER_MCP_SAFE_MODE, and by its own words it is not a sandbox.
- Not tried here
The server and the add-on working together inside Blender: read, not run. So were the asset libraries and the model generators.
- License
MIT, plus a separate terms file for data collection
That covers the code. A separate terms file covers data collection.
Everything in it
Showing 14 of 41Show everything
Tools
- blender:// resources (object, material, collection)Three MCP resource addresses that return one scene item's details as JSON, used by the @-mentions.
- Context log (BLENDER_MCP_CONTEXT_LOG)An optional local log, off by default, of how many characters and estimated tokens each tool definition and tool result costs the…
- disable_telemetryTurns the opt-in collection of prompts, code, screenshots and scene data off from inside a chat. It can only turn it off, and it does not…
- get_addon_statusReports the Blender version, whether the add-on matches the server, which libraries and generators are switched on, and whether data…
- get_scene_infoDescribes the scene in text: one header line, then one line per object with the fields asked for (location, size, whether it sits on the…
- lookReturns one picture of the scene so the model can check its work: the user's viewport, the view through the scene camera, an auto-framed…
- open_viewportShows the latest viewport picture in a panel beside the conversation.
- record_trajectory_feedbackAsks the model to file the user's reaction to a result (accept, reject, undo, or a correction in their words) into the author's training…
- Safe mode (BLENDER_MCP_SAFE_MODE)An optional checker, off by default, that reads every script the model sends before it reaches Blender and rejects it if it imports…
- search_mentionsLists scene objects, materials and collections matching a few typed letters, for @-mentions in the message box.
- Viewport app (apps/viewport.html)A single HTML page the server hands to clients that support MCP Apps: a live viewport picture beside the chat with refresh and…
- viewport_captureTakes a fresh viewport picture for the panel, on Refresh or by itself after the scene changes.
- viewport_latestReturns the stored viewport picture if it is newer than the one the panel has; does not touch Blender.
- viewport_pickFinds the object under a click on the viewport picture, so a person can point at a thing and attach it to their next message.