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.
Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
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
Compare all alternatives →
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.