ahujasid/mcp-for-blender

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/ahujasid/mcp-for-blender.svg?style=card)](https://bestofgithub.dev/repo/ahujasid/mcp-for-blender)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/ahujasid/mcp-for-blender.svg)](https://bestofgithub.dev/repo/ahujasid/mcp-for-blender)

Loading README…


Two-way communication	Connect Claude AI to Blender through a socket-based server
Object manipulation	Create, modify, and delete 3D objects in Blender
Material control	Apply and modify materials and colors
Visual verification	Multi-angle, camera, wireframe, X-ray and animation-strip views, plus renders, so the AI checks its own work
Code execution	The AI writes Blender Python directly
Asset & model generation	Poly Haven assets, Sketchfab models, Poly Pizza low-poly models, and AI-generated 3D models via Meshy, Tripo, Hyper3D Rodin and Hunyuan3D

Variable	Default	Description
`BLENDER_HOST`	`localhost`	Host address for Blender socket server
`BLENDER_PORT`	`9876`	Port number for Blender socket server
`BLENDER_MCP_SAFE_MODE`	off	Set to `1` to validate scripts before they run in Blender (see below)
`BLENDER_MCP_APPS`	auto	Set to `1` to force the inline viewport app on for clients that support MCP Apps without advertising it (the Codex plugin sets this)
`BLENDER_MCP_OPENAI_FORMS`	auto	Set to `1` to force the thumbnail asset pickers on (the Codex plugin sets this)

Tool	What it's for
`execute_blender_code`	Run Python in your live Blender
`look`	See the result from the `viewport`, `camera`, `angles` (auto-framed multi-view sheet, any direction) or `frames` (animation strip), drawn `solid`, `material`, `rendered`, `wireframe` or `xray`; or show a render or image file
`get_scene_info`	Compact scene summary, one line per object with the fields you pick (placement, materials, topology, weights, ...); drill in with `root` or `query`
`generate_3d`	One call to generate and import a model with Tripo, Hunyuan3D, Hyper3D Rodin or Meshy. Premium generators are preferred automatically
`search_assets` / `import_asset`	Poly Haven HDRIs, textures and models, Sketchfab models, Poly Pizza low-poly models
`get_addon_status`	Blender version, addon version, and which libraries and generators are switched on
`disable_telemetry`, `record_trajectory_feedback`	Data collection controls

Account	Service the addon calls	Region	Sidebar toggle
Mainland (cloud.tencent.com)	AI3D 3.0 (`ai3d`, version `2025-05-13`)	`ap-guangzhou`	leave International (Pro) account off (default)
International (tencentcloud.com), Hunyuan-to-3D (Professional)	`hunyuan`, version `2023-09-01`, PBR enabled	`ap-singapore`	tick International (Pro) account

Prompt	Demo
"Create a low poly scene in a dungeon, with a dragon guarding a pot of gold"	Watch
"Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven"	Watch
Give a reference image, and create a Blender scene out of it	Watch
"Get information about the current scene, and make a threejs sketch from it"	Watch
"Generate a 3D model of a garden gnome through Hyper3D"
"Generate a wooden rocking chair with Meshy"
"Generate a ceramic teapot with Tripo"
"Fill this room with low-poly furniture from Poly Pizza"
"Make this car red and metallic"
"Create a sphere and place it above the cube"
"Make the lighting like a studio"
"Point the camera at the scene, and make it isometric"

Problem	Fix
Connection issues	Make sure the Blender addon server is running, and the MCP server is configured on Claude. Do not run the `uvx` command in the terminal. Sometimes the first command won't go through, but after that it starts working.
Timeout errors	Try simplifying your requests or breaking them into smaller steps.
Blender freezes during a Poly Haven download	Assets are downloaded on Blender's main thread, so the UI stops responding until the transfer finishes. File size grows roughly fourfold per resolution step, so ask for 1k or 2k unless the asset is held close to camera.
Poly Pizza download fails with a Cloudflare challenge	`static.poly.pizza` is behind bot protection and blocks datacenter, VPN and cloud IPs. Your API key is fine - the CDN never sees it. Retry from a normal connection, or download the `.glb` by hand and use File → Import → glTF 2.0.
Have you tried turning it off and on again?	If you're still having connection errors, try restarting both Claude and the Blender server.

Variable
`BLENDERMCP_SKETCHFAB_API_KEY`
`BLENDERMCP_POLYPIZZA_API_KEY`
`BLENDERMCP_HYPER3D_API_KEY`
`BLENDERMCP_HUNYUAN3D_SECRET_ID`
`BLENDERMCP_HUNYUAN3D_SECRET_KEY`
`BLENDERMCP_HUNYUAN3D_API_URL`
`BLENDERMCP_MESHY_API_KEY`
`BLENDERMCP_TRIPO_API_KEY`

Quickstart

Table of Contents

Features

Premium

Components

Installation

Automatic setup

Prerequisites

Make your client find uvx

Pin the Python version

Install without uv

Run with Docker

Environment Variables

Safe mode

MCP Client Setup

Claude for Desktop

Codex

Codex plugin (recommended)

Plain MCP server

Cursor

Visual Studio Code

OpenCode

Antigravity

Installing the Blender Addon

Upgrading (existing users)

Usage

Starting the Connection

Using with Claude

Capabilities

Hunyuan3D on Tencent Cloud (Official API mode)

Tripo

Meshy

Poly Haven

Poly Pizza

Example Commands

Persistent API Credentials

Troubleshooting

Technical Details

Communication Protocol

Limitations & Security Considerations

Telemetry Control

Feedback

Join the Community

Contributing

Disclaimer

Star History