> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-for-blender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blender MCP Configuration Reference

> Full reference for Blender MCP environment variables, persistent API credentials, server configuration, and the Blender addon preferences panel.

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.

1. In Blender, open **Edit → Preferences → Add-ons**
2. Search for **Blender MCP** under the **Interface** category
3. 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.

```json theme={null}
{
  "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"
      }
    }
  }
}
```

<Note>
  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.
</Note>