By boernmaster
Control Blender headlessly via Claude Code using the blender-remote MCP. Covers session management, scene/material setup, CAD file import, and Cycles/CUDA rendering.
npx claudepluginhub boernmaster/blender_skill --plugin blender-remoteThis skill should be used when the user asks to import STP, STEP, STL, OBJ, FBX, or GLTF files into Blender, load a CAD assembly, import files from a folder, read an Excel BOM spreadsheet to map parts to materials, or work with CAD geometry in Blender. Also use when the user mentions a .stp or .step file.
This skill should be used when the user asks to render, set up rendering, enable CUDA, configure Cycles, set render resolution or samples, render an animation, output a PNG or EXR, create an animated GIF, or combine rendered frames into a video or GIF in Blender.
This skill should be used when the user asks to set up a scene, add lighting, assign materials, create metallic or realistic materials, set up studio lighting, three-point lighting, add an HDRI background, enable ambient occlusion, or configure screen-space reflections in Blender.
This skill should be used when the user asks to start Blender, stop Blender, restart Blender, check the MCP connection, set up a Blender session, or troubleshoot "blender not connected", "MCP not found", "port in use", or "CUDA not detected" errors.
Control Blender headlessly with natural language via Claude Code and the blender-remote MCP.
uv package managerclaude plugin marketplace add boernmaster/blender_skill
claude plugin install blender-remote@blender_skill
uv sync
blender-remote-cli init --blender-path $(which blender)
blender-remote-cli install
BLENDER_VERSION=$(blender --version | head -1 | awk '{print $2}' | cut -d. -f1,2)
mkdir -p ~/.config/blender/$BLENDER_VERSION/scripts/startup
cat > ~/.config/blender/$BLENDER_VERSION/scripts/startup/enable_cuda.py << 'EOF'
import bpy
def enable_cuda():
try:
cprefs = bpy.context.preferences.addons['cycles'].preferences
cprefs.compute_device_type = 'CUDA'
cprefs.get_devices()
for device in cprefs.devices:
device.use = (device.type == 'CUDA')
bpy.context.scene.cycles.device = 'GPU'
bpy.context.scene.render.engine = 'CYCLES'
bpy.ops.wm.save_userpref()
except Exception as e:
print(f"CUDA setup failed: {e}")
import bpy.app.timers
bpy.app.timers.register(enable_cuda, first_interval=1.0)
EOF
Add to ~/.bashrc (replace <project-dir> with your actual path):
alias blender-start='cd <project-dir> && source .venv/bin/activate && fuser -k 6688/tcp 2>/dev/null; pkill -f blender 2>/dev/null; sleep 1 && blender-remote-cli start --background --port 6688'
alias blender-stop='fuser -k 6688/tcp 2>/dev/null; pkill -f blender 2>/dev/null'
alias blender-restart='blender-stop && sleep 1 && blender-start'
source ~/.bashrc
Two terminals are required. Both must stay running.
Terminal 1 — start Blender:
blender-start
Terminal 2 — start Claude Code:
source .venv/bin/activate
claude
Verify the MCP connection inside Claude Code:
/mcp
blender must appear as an active server before issuing any commands.
The plugin provides four skills that load automatically when relevant:
| Skill | Use when you want to... |
|---|---|
session-setup | Start/stop/restart Blender, fix MCP or CUDA issues |
scene-materials | Set up lighting, assign metallic materials, add HDRI |
cad-import | Import STL/OBJ files, read Excel BOM, batch import |
rendering | Configure Cycles/CUDA, render frames, export GIF |
Import all STL files from /data/parts and assign materials from bom.xlsx
Set up three-point studio lighting with a white shadow-catching floor
Render a 360° orbit animation and save as /tmp/output.gif
Enable CUDA and render the current scene to /tmp/render.png at 1920x1080
Port in use
fuser -k 6688/tcp
CUDA not detected
nvidia-smi
blender-remote-cli init --blender-path $(which blender)
blender not listed in /mcp — restart Blender in Terminal 1, then check again.
Addon install fails
blender-remote-cli install --force
Persistent memory system for Claude Code - seamlessly preserve context across sessions
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Intelligent prompt optimization using skill-based architecture. Enriches vague prompts with research-based clarifying questions before Claude Code executes them
Streamline people operations — recruiting, onboarding, performance reviews, compensation analysis, and policy guidance. Maintain compliance and keep your team running smoothly.
Memory compression system for Claude Code - persist context across sessions