# Frugal Blender MCP

Connects coding agents to Blender via four tools, keeping baseline context consumption at 338 tokens through lazy schemas and request batching.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: mohakmalviya
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mohakmalviya/frugal-blender-mcp
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/frugal-blender-mcp

## What it does

This server bridges AI agents in Claude Code, Codex, or Cursor with Blender 4.2 or newer. Common integrations register dozens of individual tools that eat up prompt context on every request. Frugal Blender exposes just four: `discover`, `execute`, `inspect`, and `capture`. The agent looks up parameter requirements on demand instead of loading them up front.

Batching handles scene assembly without round-trip lag. A single `execute` call packs up to 100 discrete operations, such as positioning meshes, tuning materials, shifting cameras, or setting keyframes. When predefined operations fall short, the built-in `python` step runs arbitrary `bpy` routines directly on Blender's main thread. Visual confirmation comes back through `capture` images rather than massive scene graph text dumps.

The server requires an active bridge inside Blender before any commands can run. You must install the companion add-on via `uvx`, activate it in user preferences, and press the bridge button in the 3D Viewport sidebar.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Works with: Blender

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add frugal-blender-mcp -- uvx frugal-blender-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from frugal-blender-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add frugal-blender-mcp -- uvx frugal-blender-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from frugal-blender-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frugal-blender-mcp": {
            "command": "uvx",
            "args": [
                "frugal-blender-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from frugal-blender-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "frugal-blender-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "frugal-blender-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from frugal-blender-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add frugal-blender-mcp uvx frugal-blender-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from frugal-blender-mcp <command>

## When to use it
- Build 3D environments from text prompts without bloating context limits
- Batch transforms, modifiers, and material assignments in one prompt
- Set animation keyframes and adjust scene lighting automatically
- Run custom Python routines through bpy directly from the agent chat

## Example prompts
- Construct a low-poly island with a lighthouse and return a capture preview.
- Distribute 80 stones across the terrain and assign a rough rock shader to each.
- Inspect current scene objects and delete any unlinked geometry.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25137
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4534
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 982
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 732

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md