
BlenderMCP
Control Blender from Claude and other LLMs for prompt-assisted 3D modeling, scene creation, and asset generation.
Add to your client
Copy the config for your MCP client and paste it into its config file.
uvx blender-mcpPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"blendermcp": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
Before you start
- Blender 3.0 or newer
- Python 3.10 or newer
- uv package manager (or pipx as an alternative)
- The BlenderMCP add-on (addon.py) installed and enabled in Blender
- Optional: Sketchfab / Hyper3D / Hunyuan3D API keys for those integrations
About BlenderMCP
BlenderMCP is a third-party MCP integration that gives an LLM two-way, socket-based control over a running Blender instance. You install the MCP server with uvx (or pipx) and add it to your MCP client, then install the bundled Blender add-on and click 'Connect to Claude' in Blender's 3D View sidebar. The model can then read scene/object data, manipulate geometry and materials, take viewport screenshots, execute Python, and pull in assets from Poly Haven and Sketchfab or generate 3D models with Hyper3D Rodin and Hunyuan3D.
Tools & capabilities (22)
get_scene_infoGet detailed information about the current Blender scene.
get_object_infoGet detailed information about a specific object in the scene by name.
get_viewport_screenshotCapture a screenshot of the Blender viewport so the model can see the scene.
execute_blender_codeRun arbitrary Python code inside Blender (powerful and potentially dangerous).
get_polyhaven_categoriesList available asset categories on Poly Haven for a given asset type (e.g. hdris).
search_polyhaven_assetsSearch Poly Haven for models, textures, and HDRIs.
download_polyhaven_assetDownload a Poly Haven asset into the Blender scene.
set_textureApply a downloaded texture to an object.
get_polyhaven_statusCheck whether the Poly Haven integration is enabled in Blender.
get_hyper3d_statusCheck whether the Hyper3D Rodin integration is enabled in Blender.
get_sketchfab_statusCheck whether the Sketchfab integration is enabled in Blender.
search_sketchfab_modelsSearch Sketchfab for downloadable 3D models.
get_sketchfab_model_previewGet a preview of a Sketchfab model before downloading it.
download_sketchfab_modelDownload a Sketchfab model into the Blender scene.
generate_hyper3d_model_via_textGenerate a 3D model from a text prompt using Hyper3D Rodin.
generate_hyper3d_model_via_imagesGenerate a 3D model from one or more input images using Hyper3D Rodin.
poll_rodin_job_statusPoll the status of a Hyper3D Rodin generation job.
import_generated_assetImport a completed Hyper3D-generated asset into Blender.
get_hunyuan3d_statusCheck whether the Hunyuan3D integration is enabled in Blender.
generate_hunyuan3d_modelGenerate a 3D model from a text prompt or image using Hunyuan3D.
poll_hunyuan_job_statusPoll the status of a Hunyuan3D generation job.
import_generated_asset_hunyuanImport a completed Hunyuan3D-generated asset into Blender.
What this server can do
BlenderMCP provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Build a low-poly scene from a natural-language prompt (e.g. a dungeon with a dragon guarding a pot of gold).
- Create an environment using HDRIs, textures, and models from Poly Haven.
- Recreate a Blender scene from a reference image.
- Generate 3D models from text or images via Hyper3D Rodin or Hunyuan3D and import them.
- Inspect the current scene and adjust materials, lighting, and camera (e.g. make a car red and metallic, set studio lighting, switch to isometric).
Security notes
The execute_blender_code tool runs arbitrary Python code inside Blender, which is powerful but potentially dangerous — use with caution and always save your work before using it. BlenderMCP collects anonymous telemetry by default; disable it with the DISABLE_TELEMETRY=true environment variable or via the add-on preferences. Poly Haven, Sketchfab, Hyper3D, and Hunyuan3D integrations require downloading assets / calling external APIs and can be turned off.
BlenderMCP FAQ
Do I need anything inside Blender besides the MCP server?
Yes. You must install the bundled addon.py add-on in Blender (Edit > Preferences > Add-ons > Install), enable 'Interface: Blender MCP', then in the 3D View sidebar open the 'BlenderMCP' tab and click 'Connect to Claude'. The MCP server in your client talks to this add-on over a TCP socket.
Is this an official Blender product?
No. It is a third-party integration made by Siddharth Ahuja and is not made by Blender.
Should I run the uvx command in my terminal myself?
No. Let the MCP client start the server. Running 'uvx blender-mcp' manually in a terminal is called out as a common cause of connection issues.
How do I disable telemetry?
Run the server with DISABLE_TELEMETRY=true (e.g. add it to the env block of your MCP config), or uncheck the telemetry consent checkbox in the Blender add-on preferences.
Can I run only one client at a time?
Yes. The docs warn to run only one instance of the MCP server (either Cursor or Claude Desktop), not both simultaneously.
Alternatives to BlenderMCP
Popular community server that feeds Figma layout data to coding agents via a Figma API token.
Generate beautiful, modern UI components from natural-language descriptions inside your IDE.
Give AI assistants full access to shadcn/ui v4 components, blocks, demos, and metadata across React, Svelte, Vue, and React Native.