BlenderLens

io.github.pzalutski-pixel/blenderlens · v0.2.0

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

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add blenderlens -e BLENDER_BIN=<BLENDER_BIN> -e BLENDERLENS_MODE=<BLENDERLENS_MODE> -e BLENDERLENS_HOST=<BLENDERLENS_HOST> -e BLENDERLENS_PORT=<BLENDERLENS_PORT> -e BLENDERLENS_TOKEN=<BLENDERLENS_TOKEN> -e BLENDERLENS_TIMEOUT=<BLENDERLENS_TIMEOUT> -e BLENDERLENS_START_TIMEOUT=<BLENDERLENS_START_TIMEOUT> -e BLENDERLENS_RENDER_DIR=<BLENDERLENS_RENDER_DIR> -e BLENDERLENS_ALLOW_PYTHON=<BLENDERLENS_ALLOW_PYTHON> -e BLENDERLENS_ALLOWED_DIRS=<BLENDERLENS_ALLOWED_DIRS> -e BLENDERLENS_RUNTIME_DIR=<BLENDERLENS_RUNTIME_DIR> -- npx -y [email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "blenderlens": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "BLENDER_BIN": "<BLENDER_BIN>",
        "BLENDERLENS_MODE": "<BLENDERLENS_MODE>",
        "BLENDERLENS_HOST": "<BLENDERLENS_HOST>",
        "BLENDERLENS_PORT": "<BLENDERLENS_PORT>",
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>",
        "BLENDERLENS_TIMEOUT": "<BLENDERLENS_TIMEOUT>",
        "BLENDERLENS_START_TIMEOUT": "<BLENDERLENS_START_TIMEOUT>",
        "BLENDERLENS_RENDER_DIR": "<BLENDERLENS_RENDER_DIR>",
        "BLENDERLENS_ALLOW_PYTHON": "<BLENDERLENS_ALLOW_PYTHON>",
        "BLENDERLENS_ALLOWED_DIRS": "<BLENDERLENS_ALLOWED_DIRS>",
        "BLENDERLENS_RUNTIME_DIR": "<BLENDERLENS_RUNTIME_DIR>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "blenderlens": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "BLENDER_BIN": "<BLENDER_BIN>",
        "BLENDERLENS_MODE": "<BLENDERLENS_MODE>",
        "BLENDERLENS_HOST": "<BLENDERLENS_HOST>",
        "BLENDERLENS_PORT": "<BLENDERLENS_PORT>",
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>",
        "BLENDERLENS_TIMEOUT": "<BLENDERLENS_TIMEOUT>",
        "BLENDERLENS_START_TIMEOUT": "<BLENDERLENS_START_TIMEOUT>",
        "BLENDERLENS_RENDER_DIR": "<BLENDERLENS_RENDER_DIR>",
        "BLENDERLENS_ALLOW_PYTHON": "<BLENDERLENS_ALLOW_PYTHON>",
        "BLENDERLENS_ALLOWED_DIRS": "<BLENDERLENS_ALLOWED_DIRS>",
        "BLENDERLENS_RUNTIME_DIR": "<BLENDERLENS_RUNTIME_DIR>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "blenderlens": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "BLENDER_BIN": "<BLENDER_BIN>",
        "BLENDERLENS_MODE": "<BLENDERLENS_MODE>",
        "BLENDERLENS_HOST": "<BLENDERLENS_HOST>",
        "BLENDERLENS_PORT": "<BLENDERLENS_PORT>",
        "BLENDERLENS_TOKEN": "<BLENDERLENS_TOKEN>",
        "BLENDERLENS_TIMEOUT": "<BLENDERLENS_TIMEOUT>",
        "BLENDERLENS_START_TIMEOUT": "<BLENDERLENS_START_TIMEOUT>",
        "BLENDERLENS_RENDER_DIR": "<BLENDERLENS_RENDER_DIR>",
        "BLENDERLENS_ALLOW_PYTHON": "<BLENDERLENS_ALLOW_PYTHON>",
        "BLENDERLENS_ALLOWED_DIRS": "<BLENDERLENS_ALLOWED_DIRS>",
        "BLENDERLENS_RUNTIME_DIR": "<BLENDERLENS_RUNTIME_DIR>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`BLENDER_BIN` Optional	Blender 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_MODE` Optional	auto (the Blender window running the add-on if it responds, otherwise a background Blender), live, or background
`BLENDERLENS_HOST` Optional	The address the server connects to for the BlenderLens add-on in live mode
`BLENDERLENS_PORT` Optional	The add-on's port, as set in its preferences
`BLENDERLENS_TOKEN` Optional, secret	Overrides the token the server reads from the add-on's connection file (live-<port>.json)
`BLENDERLENS_TIMEOUT` Optional	Seconds to wait for one call; render_preview, run_python, run_script and bake_texture also take a timeout of their own
`BLENDERLENS_START_TIMEOUT` Optional	Seconds to wait for a background Blender to come up
`BLENDERLENS_RENDER_DIR` Optional	Where 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_PYTHON` Optional	0 leaves run_python and run_script out of the tool list and refuses them (not_allowed)
`BLENDERLENS_ALLOWED_DIRS` Optional	Folders 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_DIR` Optional	Where 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

Details

Package	`[email protected]` (NPM, stdio)
Package	`[email protected]` (PYPI, stdio)
First published	10 Oct 2026
Last updated	10 Oct 2026
Registry name	`io.github.pzalutski-pixel/blenderlens`

More ai and media servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use BlenderLens often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-pzalutski-pixel-blenderlens/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-pzalutski-pixel-blenderlens)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.