MCP server
BlenderLens
MCP server that lets AI agents build, check, preview and export game assets in Blender
Runs locally
- 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-mcpAdd 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 unsetBLENDERLENS_MODEauto (the Blender window running the add-on if it responds, otherwise a background Blender), live, or backgroundBLENDERLENS_HOSTThe address the server connects to for the BlenderLens add-on in live modeBLENDERLENS_PORTThe add-on's port, as set in its preferencesBLENDERLENS_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 ownBLENDERLENS_START_TIMEOUTSeconds to wait for a background Blender to come upBLENDERLENS_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 startsBLENDERLENS_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 confinedBLENDERLENS_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 elsewhereBLENDER_BINBlender executable, for background sessions, install-addon, and the check command on a .blend; found on PATH or in the usual install folders when unsetBLENDERLENS_MODEauto (the Blender window running the add-on if it responds, otherwise a background Blender), live, or backgroundBLENDERLENS_HOSTThe address the server connects to for the BlenderLens add-on in live modeBLENDERLENS_PORTThe add-on's port, as set in its preferencesBLENDERLENS_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 ownBLENDERLENS_START_TIMEOUTSeconds to wait for a background Blender to come upBLENDERLENS_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 startsBLENDERLENS_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 confinedBLENDERLENS_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.