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 34 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.
- Codex pluginA Codex plugin wrapper around the same server that switches on the viewport panel beside the chat, thumbnail pickers for the asset…
- 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…
- DockerfileRuns the MCP server in a container while Blender stays on the host; the image points at host.docker.internal:9876.
- execute_blender_codeRuns Python the model writes inside the user's open Blender, with the full bpy API, and returns whatever it printed. This is the tool that…
- generate_3dMakes one textured 3D model from a short text prompt or an image and imports it, through Tripo, Hunyuan3D, Hyper3D Rodin or Meshy. One…
- 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…
- Hunyuan3DText or image to a model through Tencent Cloud's Hunyuan API (mainland or international account), or through a Hunyuan3D server the user…
- Hyper3D RodinText or image to a textured model through Hyper3D's own site or through fal.ai. The add-on carries a shared free-trial key for the main…
- import_assetDownloads an asset found by search_assets and brings it into the scene: an HDRI becomes the world lighting, a texture set becomes a…
- install.sh / install.ps1The one-line installers the README leads with. Each installs uv by piping uv's own installer into a shell if uv is missing, then runs 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…
- MCP for Blender add-on (addon.py 1.8, protocol 15)One 7,200-line Blender add-on that opens a socket server inside Blender and carries out the commands sent to it: run Python, describe the…
- MCP for Blender PremiumThe author's paid plan: one license key instead of four generator keys. The add-on sends the license key, a device ID and each prompt or…
- MCP for Blender server (mcp-for-blender 2.2.7)The Python program an agent's app starts: it speaks MCP to the agent and plain JSON over a local TCP socket (this machine, port 9876) to…
- mcp-for-blender install-addon / addon-pathsCopies the add-on bundled with the package into Blender's add-ons folder and prints where it wrote; addon-paths lists the Blender add-on…
- mcp-for-blender setupA command that finds the AI apps on the machine (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Devin Desktop or Windsurf, OpenCode…
- mcp-for-blender updateChecks PyPI for a newer release, refreshes uv's cached copy so the next launch uses it, and replaces every installed copy of the add-on…
- MeshyText or image to a textured model sized to real-world height with its origin on the ground; on the user's own key it can make a character…
- open_viewportShows the latest viewport picture in a panel beside the conversation.
- Poly HavenAbout 2,400 HDRIs, PBR texture sets and models, all CC0, fetched from api.polyhaven.com with no key and no account. HDRIs are packed into…
- Poly PizzaAbout 10,600 low-poly models as single .glb files, CC0 or CC-BY; the credit line is written onto each imported object. The README says…
- 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_assetsSearches three existing libraries: Poly Haven (HDRIs, PBR textures and realistic models, all CC0, no key), Sketchfab (user-made models…
- search_mentionsLists scene objects, materials and collections matching a few typed letters, for @-mentions in the message box.
- SketchfabSearch and download of user-made models from Sketchfab. Licenses differ per model, so each one has to be checked before it goes into…
- TripoText or image to a textured model through Tripo, on the user's own key or through Premium.
- 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.