# ahujasid/blender-mcp [Health: Active]

**Category:** 🎨 Art & Culture  
**Repository:** https://github.com/ahujasid/blender-mcp  
**GitHub Stars:** 27893  
**npm Downloads (last month):** 986  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ahujasid-blender-mcp

## Description
Open-source MCP to use Blender with any LLM

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "blender-mcp": {
    "command": "uvx",
    "args": ["blender-mcp"]
  }
}
```

## Documentation

## What ahujasid/blender-mcp does

The ahujasid/blender-mcp MCP server links an MCP client with a running Blender installation. It is intended for AI-assisted 3D work, including creating and editing objects, changing materials and colors, inspecting scene contents, and running Python code inside Blender.

The project is a third-party integration rather than an official Blender component. Its workflow requires both the MCP server and a Blender addon. The addon runs inside Blender and exposes a socket endpoint for receiving commands, while the Python MCP server implements the Model Context Protocol and forwards requests to that addon.

## How it works

The MCP server runs as a local Python process, commonly through `uvx`. Blender hosts the other half of the connection through the installed addon. After the addon is enabled, the user opens Blender's 3D viewport sidebar, selects the MCP for Blender panel, and starts the MCP server there.

Only one MCP server instance should be active at a time. For example, do not run separate instances through both Claude Desktop and Cursor while connecting to the same Blender setup.

The listed asset capabilities include access to Poly Haven assets, Sketchfab models, Poly Pizza low-poly models, and AI-generated 3D models through Hyper3D Rodin and Hunyuan3D. The provided material does not specify the credentials or configuration required by those external services.

## Setup and configuration

The ahujasid/blender-mcp MCP server requires Blender 3.0 or newer, Python 3.10 or newer, and the `uv` package manager for the recommended setup. Install `uv` using its official platform-specific installer, then configure the MCP client with the `uvx blender-mcp` command.

The Blender addon is installed with:

```bash
uvx blender-mcp install-addon
```

After installation, enable **Interface: MCP for Blender** under Blender's Add-ons preferences. Start the connection from the addon's panel in the 3D viewport.

GUI-launched clients may not inherit the same PATH as a terminal. If the client cannot find `uvx`, configure the full path to that executable or use the documented Windows `cmd` wrapper. The documentation also recommends pinning Python 3.11 with uv when interpreter or dependency conflicts occur. `pipx` and Docker are documented as alternative deployment methods.

## Tools and capabilities

Supported operations described by the project include:

- Create, modify, and delete Blender objects.
- Inspect the current scene and retrieve detailed scene information.
- Apply and change materials and object colors.
- Execute arbitrary Python code within Blender from the connected LLM.
- Work with listed online and generated 3D asset sources.

These capabilities allow an agent to perform scene-editing tasks through natural-language requests, provided Blender is open, the addon is enabled, and the connection has been started.

## Limitations and notes

The ahujasid/blender-mcp MCP server controls a local Blender application; the Docker option hosts only the MCP server, while Blender remains on the user's machine. Running arbitrary Python inside Blender means requests can perform broad actions in that environment, so the setup should be used with appropriate care.

The integration is not made by Blender. The documentation does not establish that every MCP client is supported, although setup instructions are provided for Claude Desktop, Claude Code, Cursor, Visual Studio Code, OpenCode, and Antigravity. External asset-generation or model services may have separate requirements that are not detailed in the supplied material.

## Getting started with this ahujasid/blender-mcp MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/ahujasid-blender-mcp/readme_