blender
Control Blender using Gemini via the Model Context Protocol
Open source Open in the app JSON README (API)
About
Control Blender using Gemini via the Model Context Protocol
Details
- Kind
- Plugins
- Topic
- Media, design & games
- Publisher
- josephku
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Stars
- 1
- Forks
- 2
- Last push
- 2025-12-30T11:33:48Z
- Repository state
- ativo
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
josephku/blender-mcp-gemini-cli-extension
README
# Blender MCP Gemini CLI Extension This extension enables Gemini CLI to interact with Blender using the Model Context Protocol (MCP). ## Contents - `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. ## Setup ### 1. Install Blender Addon 1. Download the latest `addon.py` file from the [official BlenderMCP repository](https://github.com/ahujasid/blender-mcp/blob/main/addon.py). 2. Open Blender (3.0+). 3. Go to **Edit > Preferences > Add-ons**. 4. Click **Install...** and select the downloaded `addon.py` file. 5. Enable the "Interface: Blender MCP" addon. 6. In the 3D Viewport Sidebar (press `N`), find the **BlenderMCP** tab. 7. Click **Connect to Claude** (starts the socket server on port 9876). ### 2. Configure Gemini CLI The `gemini-extension.json` file contains the necessary configuration. Run the following command to install this extension: ```bash gemini extension install https://github.com/JosephKu/blender-mcp-gemini-cli-extension ``` To install a specific version (e.g., v1.0.0): ```bash gemini extension install https://github.com/JosephKu/blender-mcp-gemini-cli-extension --ref v1.0.0 ``` ### 3. Updating To update the extension to the latest version: ```bash gemini extension update blender ``` Or to update all extensions: ```bash gemini extension update --all ``` ### 4. Usage Once 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" ## Requirements - Blender 3.0+ - Python 3.10+ - `uv` package manager