This extension enables Gemini CLI to interact with Blender using the Model Context Protocol (MCP).
gemini-extension.json: The extension definition and MCP configuration for Gemini CLI.GEMINI.md: System instructions for the Gemini model to effectively use Blender tools.
- Download the latest
addon.pyfile from the official BlenderMCP repository. - Open Blender (3.0+).
- Go to Edit > Preferences > Add-ons.
- Click Install... and select the downloaded
addon.pyfile. - Enable the "Interface: Blender MCP" addon.
- In the 3D Viewport Sidebar (press
N), find the BlenderMCP tab. - Click Connect to Claude (starts the socket server on port 9876).
The gemini-extension.json file contains the necessary configuration.
Run the following command to install this extension:
gemini extension install https://github.com/JosephKu/blender-mcp-gemini-cli-extensionTo install a specific version (e.g., v1.0.0):
gemini extension install https://github.com/JosephKu/blender-mcp-gemini-cli-extension --ref v1.0.0To update the extension to the latest version:
gemini extension update blenderOr to update all extensions:
gemini extension update --allOnce connected, you can ask Gemini to:
- "Create a cube and move it to (0,0,5)"
- "List all objects in the scene"
- "Download a brick texture from Poly Haven"
- "Run a python script to scatter trees"
- Blender 3.0+
- Python 3.10+
uvpackage manager