Blender MCP Configuration Reference

Blender MCP is configured via environment variables in your MCP client config, or via Blender’s Add-on Preferences panel. This page is the complete reference for all settings.

MCP Server Environment Variables

These variables control how the MCP server connects to Blender and how it behaves.

Variable	Default	Description
`BLENDER_HOST`	`localhost`	Host address of the Blender socket server
`BLENDER_PORT`	`9876`	Port of the Blender socket server
`DISABLE_TELEMETRY`	(unset)	Set to `true` to disable all telemetry collection
`UV_PYTHON_PREFERENCE`	(unset)	Set to `only-managed` to prevent uv from using system Python
`BLENDERMCP_ADDONS_DIR`	(unset)	Override the default path for addon installation

Credential Environment Variables

You can store integration API keys as environment variables instead of entering them in Blender. The MCP server reads these at startup.

Variable	Integration
`BLENDERMCP_SKETCHFAB_API_KEY`	Sketchfab
`BLENDERMCP_POLYPIZZA_API_KEY`	Poly Pizza
`BLENDERMCP_HYPER3D_API_KEY`	Hyper3D Rodin
`BLENDERMCP_HUNYUAN3D_SECRET_ID`	Hunyuan3D
`BLENDERMCP_HUNYUAN3D_SECRET_KEY`	Hunyuan3D
`BLENDERMCP_HUNYUAN3D_API_URL`	Hunyuan3D (for local API mode)

Blender Add-on Preferences Panel

Persistent credentials and telemetry settings are stored inside Blender so they survive restarts.

In Blender, open Edit → Preferences → Add-ons
Search for Blender MCP under the Interface category
Expand the addon panel to reveal:
- Sketchfab API Key
- Poly Pizza API Key
- Hyper3D API Key
- Hunyuan3D Secret ID
- Hunyuan3D Secret Key
- Hunyuan3D API URL
- Telemetry Consent checkbox

Values you enter here are saved to Blender’s user preferences and do not need to be re-entered each session.

MCP Client Config Examples

The following JSON shows a complete Claude Desktop configuration with all optional environment variables set.

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"],
      "env": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876",
        "DISABLE_TELEMETRY": "true",
        "BLENDERMCP_SKETCHFAB_API_KEY": "your-sketchfab-key",
        "BLENDERMCP_POLYPIZZA_API_KEY": "your-polypizza-key",
        "BLENDERMCP_HYPER3D_API_KEY": "your-hyper3d-key",
        "BLENDERMCP_HUNYUAN3D_SECRET_ID": "your-hunyuan-id",
        "BLENDERMCP_HUNYUAN3D_SECRET_KEY": "your-hunyuan-key",
        "BLENDERMCP_HUNYUAN3D_API_URL": "https://your-local-api.example.com"
      }
    }
  }
}

You only need to include the variables you want to override. If an entry is omitted, the MCP server uses its built-in default or reads the value from Blender’s Add-on Preferences panel.

Get Started

Core Concepts

Integrations

Use Cases

Reference

Blender MCP Configuration Reference

MCP Server Environment Variables

Credential Environment Variables

Blender Add-on Preferences Panel

MCP Client Config Examples

​MCP Server Environment Variables

​Credential Environment Variables

​Blender Add-on Preferences Panel

​MCP Client Config Examples

MCP Server Environment Variables

Credential Environment Variables

Blender Add-on Preferences Panel

MCP Client Config Examples