Skip to content
MCP server

BlenderLens

MCP server that lets AI agents build, check, preview and export game assets in Blender

Runs locally
Install
Pricing
Open source
Runs
Locally
Version
0.2.0
Listing updated
1 month ago

About BlenderLens

BlenderLens is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add blenderlens --env BLENDERLENS_TOKEN='<BLENDERLENS_TOKEN>' -- npx -y blenderlens-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "blenderlens": {
      "command": "npx",
      "args": [
        "-y",
        "blenderlens-mcp"
      ],
      "env": {
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "blenderlens": {
      "command": "npx",
      "args": [
        "-y",
        "blenderlens-mcp"
      ],
      "env": {
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "blenderlens": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "blenderlens-mcp"
      ],
      "env": {
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "blenderlens": {
      "command": "npx",
      "args": [
        "-y",
        "blenderlens-mcp"
      ],
      "env": {
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "blenderlens": {
      "command": "npx",
      "args": [
        "-y",
        "blenderlens-mcp"
      ],
      "env": {
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BLENDER_BINBlender executable, for background sessions, install-addon, and the check command on a .blend; found on PATH or in the usual install folders when unset
  • BLENDERLENS_MODEauto (the Blender window running the add-on if it responds, otherwise a background Blender), live, or background
  • BLENDERLENS_HOSTThe address the server connects to for the BlenderLens add-on in live mode
  • BLENDERLENS_PORTThe add-on's port, as set in its preferences
  • BLENDERLENS_TOKENOverrides the token the server reads from the add-on's connection file (live-<port>.json)
  • BLENDERLENS_TIMEOUTSeconds to wait for one call; render_preview, run_python, run_script and bake_texture also take a timeout of their own
  • BLENDERLENS_START_TIMEOUTSeconds to wait for a background Blender to come up
  • BLENDERLENS_RENDER_DIRWhere render_preview writes when given no path. When unset, blenderlens/renders in the system temp folder, where previews older than 7 days are removed when the server starts
  • BLENDERLENS_ALLOW_PYTHON0 leaves run_python and run_script out of the tool list and refuses them (not_allowed)
  • BLENDERLENS_ALLOWED_DIRSFolders that every path given to a tool must lie inside, separated by ; on Windows and : elsewhere. render_preview may also write to its render folder (BLENDERLENS_RENDER_DIR). When unset, paths are not confined
  • BLENDERLENS_RUNTIME_DIRWhere the add-on writes live-<port>.json for the server, and where recovery copies go; Blender and the server must agree. Default: %LOCALAPPDATA%\blenderlens on Windows, ~/Library/Application Support/blenderlens on macOS, and $XDG_STATE_HOME/blenderlens or ~/.local/state/blenderlens elsewhere
  • BLENDER_BINBlender executable, for background sessions, install-addon, and the check command on a .blend; found on PATH or in the usual install folders when unset
  • BLENDERLENS_MODEauto (the Blender window running the add-on if it responds, otherwise a background Blender), live, or background
  • BLENDERLENS_HOSTThe address the server connects to for the BlenderLens add-on in live mode
  • BLENDERLENS_PORTThe add-on's port, as set in its preferences
  • BLENDERLENS_TOKENOverrides the token the server reads from the add-on's connection file (live-<port>.json)
  • BLENDERLENS_TIMEOUTSeconds to wait for one call; render_preview, run_python, run_script and bake_texture also take a timeout of their own
  • BLENDERLENS_START_TIMEOUTSeconds to wait for a background Blender to come up
  • BLENDERLENS_RENDER_DIRWhere render_preview writes when given no path. When unset, blenderlens/renders in the system temp folder, where previews older than 7 days are removed when the server starts
  • BLENDERLENS_ALLOW_PYTHON0 leaves run_python and run_script out of the tool list and refuses them (not_allowed)
  • BLENDERLENS_ALLOWED_DIRSFolders that every path given to a tool must lie inside, separated by ; on Windows and : elsewhere. render_preview may also write to its render folder (BLENDERLENS_RENDER_DIR). When unset, paths are not confined
  • BLENDERLENS_RUNTIME_DIRWhere the add-on writes live-<port>.json for the server, and where recovery copies go; Blender and the server must agree. Default: %LOCALAPPDATA%\blenderlens on Windows, ~/Library/Application Support/blenderlens on macOS, and $XDG_STATE_HOME/blenderlens or ~/.local/state/blenderlens elsewhere

Pricing

Open source

BlenderLens FAQ

Is BlenderLens free?

Yes. BlenderLens is open source, so you can use and self-host it for free.

How do I add BlenderLens to Claude Code?

Run this command in your terminal: claude mcp add blenderlens --env BLENDERLENS_TOKEN='<BLENDERLENS_TOKEN>' -- npx -y blenderlens-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers