
mcp-for-blender
Build and edit 3D scenes in your running Blender.
- GitHub stars
- 34.9K
Install
/plugin install mcp-for-blender@mcp-for-blenderRun it inside Claude Code after adding the marketplace with /plugin marketplace add ahujasid/mcp-for-blender.
Contents
Discovered from sourceAgents 1
MCP for Blender
A community-built, open-source project. Not affiliated with or endorsed by the Blender Foundation.
MCP for Blender connects Claude to the Blender running on your computer. Claude can read your scene, write and run Blender Python to create and edit objects, materials, lighting and animation, and look at the result from any angle to check its own work. It can also pull free models, textures and HDRIs from Poly Haven, Sketchfab and Poly Pizza, and generate new 3D models or Gaussian-splat worlds with services you choose to switch on.
The plugin runs the open-source mcp-for-blender server on your machine. Source: github.com/ahujasid/mcp-for-blender.
Where it works
- Claude Code: terminal, IDE extensions and the desktop app's Code tab
- Cowork, when the session runs on your computer
The server talks to Blender on your machine, so it doesn't run in Claude chat on the web or mobile.
Setup
-
Install uv, which runs the server.
-
Install the Blender addon. From a terminal:
uvx mcp-for-blender==2.3.1 install-addonOr download
addon.pyand install it in Blender under Edit → Preferences → Add-ons → Install…. -
In Blender, enable Interface: MCP for Blender, open the MCP for Blender tab in the 3D viewport's sidebar (press N) and click Connect to Claude.
-
Install the plugin. In Claude Code:
/plugin install mcp-for-blender --marketplace ahujasid/mcp-for-blender -
Ask Claude to build something.
If you added the server by hand before (claude mcp add blender …), remove that entry so Claude doesn't see the tools twice.
Tools
| Tool | What it does |
|---|---|
get_addon_status | Blender version, addon version, and which libraries and generators are switched on |
get_scene_info | Objects in the scene with their positions and sizes |
execute_blender_code | Runs Python inside Blender with the full bpy API |
look | Viewport screenshots from any angle, and renders |
search_assets, import_asset | Find and import models, textures and HDRIs from Poly Haven, Sketchfab and Poly Pizza |
generate_3d | Generates one textured model from text or an image (Hyper3D Rodin, Hunyuan3D, Meshy, Tripo) |
generate_gaussian_world | Generates a Gaussian-splat world with World Labs |
record_trajectory_feedback | Records your feedback on a session, only if you opted in to sharing |
disable_telemetry | Stops sharing prompts, code, screenshots and scene data, if you opted in |
What it runs, sends and fetches
- Runs: the server from the wheel shipped in this plugin (
vendor/mcp_for_blender-2.3.1-py3-none-any.whl, the same file as the 2.3.1 release on PyPI), started withuvx. uv installs its dependencies (mcpandhttpx) from PyPI. - Blender: the server connects to the addon over a local socket (
localhost:9876by default).execute_blender_coderuns arbitrary Python in Blender, so save your work. The socket has no authentication, so keep it onlocalhost. - Asset libraries: when you switch them on in the addon, Blender searches and downloads from Poly Haven (
api.polyhaven.com), Sketchfab (api.sketchfab.com, with your API key) and Poly Pizza (api.poly.pizza, with your API key). Search results show thumbnails from those services. - 3D generation: when you switch a generator on, Blender sends your prompt or image to that provider with your own API key: Hyper3D Rodin (
hyperhuman.deemos.com, orqueue.fal.runin fal.ai mode), Hunyuan3D (Tencent Cloud), Meshy (api.meshy.ai), Tripo (openapi.tripo3d.ai, oropenapi.tripo3d.comfor China accounts) or World Labs (api.worldlabs.ai). With an MCP for Blender Premium subscription, the request goes through the MCP for Blender backend (hosted on Supabase) instead, which calls the provider for you. - Addon updates: when Blender starts, the addon checks
raw.githubusercontent.com/ahujasid/blender-mcpfor a neweraddon.pyand shows an Update Addon button if there is one. It installs nothing unless you click it. SetBLENDERMCP_NO_UPDATE_CHECK=1to skip the check. - Telemetry: by default, the server sends a minimal anonymous usage record to the MCP for Blender backend (Supabase): a random install ID, a session ID, the tool name, whether it succeeded, how long it took, the MCP for Blender and Blender versions, your operating system and a timestamp. Your prompts, code, screenshots and scene data are not sent unless you opt in, either in the addon preferences or through a one-time prompt some clients show. Asking Claude to stop data collection (
disable_telemetry) turns off that opt-in sharing. To also turn off the anonymous usage record, setDISABLE_TELEMETRY=truein the environment Claude runs in. - Local files: the server keeps its install ID and a list of pending generations in your user data folder. It never modifies your Blender addon files on its own.
API keys are stored in Blender's add-on preferences, not in this plugin.
Privacy Policy
The privacy policy covers what is collected, how it's used and stored, who it's shared with, how long it's kept, and how to reach us. Full terms for opt-in data are in TERMS_AND_CONDITIONS.md. Contact: ahujasid@gmail.com.
Support
mcp-for-blender.com/support, GitHub issues or Discord.
License
MIT. See LICENSE.
MCP servers 1
Sponsors
Details
- Marketplace
- ahujasid/mcp-for-blender
- Source
- integrations/claude/mcp-for-blender
- Category
- Community