{"id":"1bd0a5cc-6a4e-4732-afe1-33eb831e6620","slug":"blender-mcp-vse","kind":"mcp","name":"blender-mcp-vse","summary":"AI-powered video editing in Blender through Claude and MCP","owner":"anan0110692","repoUrl":"https://github.com/anan0110692/blender-mcp-vse","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-01-30T20:57:02.000Z","addedAt":"2026-10-21T20:32:08.576Z","logoUrl":"https://avatars.githubusercontent.com/u/46865587?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["design-media"],"tags":[],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-27T23:10:09.683Z","sample":false,"url":"https://conduits.dev/tools/blender-mcp-vse","language":"Python","transports":["stdio"],"install":{"pypi":"blender-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# BlenderMCP-VSE - Blender Video Editing with AI\n\n<p align=\"center\">\n  <img src=\"assets/hammer-icon.png\" alt=\"BlenderMCP-VSE\" width=\"120\"/>\n</p>\n\n**BlenderMCP-VSE** extends the original [BlenderMCP](https://github.com/ahujasid/blender-mcp) project with a complete **Video Sequence Editor (VSE)** integration, enabling AI-powered video editing through Claude and the Model Context Protocol (MCP).\n\nThis fork transforms Blender into an AI-controllable video editing suite, allowing you to edit videos, add effects, manage audio, and render outputs - all through natural language commands.\n\n---\n\n## What's New in This Fork\n\n### Video Sequence Editor (VSE) Integration\n\nThis fork adds **30+ new tools** for complete video editing capabilities:\n\n| Category | Tools |\n|----------|-------|\n| **Strip Management** | Add movie, sound, image, image sequence, scene, color, and text strips |\n| **Strip Editing** | Move, trim, cut, duplicate, delete strips |\n| **Effects & Transitions** | Cross-fade, wipe, gamma cross, and other transitions |\n| **Audio Control** | Volume, pan, and audio strip management |\n| **Advanced Effects** | Speed control, adjustment layers, effect strips |\n| **Timeline Control** | Frame navigation, preview range, playback control |\n| **Organization** | Meta strips for grouping, multi-strip selection |\n| **Export** | Render settings, codec selection, animation rendering |\n\n---\n\n## Features\n\n### Original BlenderMCP Features\n- **Two-way Communication**: Connect Claude AI to Blender through socket-based server\n- **3D Object Manipulation**: Create, modify, and delete 3D objects\n- **Material Control**: Apply and modify materials and colors\n- **Scene Inspection**: Get detailed information about the current scene\n- **Code Execution**: Run Python code in Blender from Claude\n- **Poly Haven Integration**: Download HDRIs, textures, and 3D models\n- **Hyper3D Rodin**: AI-generated 3D models\n- **Sketchfab Integration**: Search and download 3D models\n- **Hunyuan3D Support**: Additional AI model generation\n\n### New VSE Features\n- **Import Media**: Add videos, audio, images, and image sequences\n- **Non-Linear Editing**: Cut, trim, move, and arrange clips on the timeline\n- **Transitions**: Add cross-fades, wipes, and other transitions between clips\n- **Text Overlays**: Add text strips with customizable properties\n- **Color Strips**: Create solid color backgrounds or overlays\n- **Audio Editing**: Control volume, pan, and audio timing\n- **Speed Effects**: Reverse playback, slow motion, speed ramping\n- **Adjustment Layers**: Apply effects across multiple strips\n- **Meta Strips**: Group strips together for organization\n- **Render Output**: Configure resolution, FPS, codec, and export video\n\n---\n\n## Installation\n\n### Prerequisites\n\n- **Blender 4.0+** (compatible with Blender 5.x)\n- **Python 3.10+**\n- **uv package manager**\n\n#### Install uv\n\n**macOS:**\n```bash\nbrew install uv\n```\n\n**Windows:**\n```powershell\npowershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\nAdd uv to PATH (Windows):\n```powershell\n$localBin = \"$env:USERPROFILE\\.local\\bin\"\n$userPath = [Environment]::GetEnvironmentVariable(\"Path\", \"User\")\n[Environment]::SetEnvironmentVariable(\"Path\", \"$userPath;$localBin\", \"User\")\n```\n\n**Linux:**\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n---\n\n### Step 1: Install the Blender Addon\n\n1. Download `addon.py` from this repository\n2. Open Blender\n3. Go to **Edit > Preferences > Add-ons**\n4. Click **\"Install...\"** and select the `addon.py` file\n5. Enable the addon by checking **\"Interface: Blender MCP\"**\n\n### Step 2: Configure MCP Server\n\n#### Claude Desktop\n\nEdit your `claude_desktop_config.json`:\n\n```json\n{\n    \"mcpServers\": {\n        \"blender\": {\n            \"command\": \"uvx\",\n            \"args\": [\"--from\", \"git+https://github.com/anan0110692/blender-mcp-vse\", \"blender-mcp\"]\n        }\n    }\n}\n```\n\n#### Claude Code CLI\n\n```bash\nclaude mcp add blender -- uvx --from git+https://github.com/anan0110692/blender-mcp-vse blender-mcp\n```\n\n#### Cursor\n\nAdd to your MCP settings (Settings > MCP):\n\n**macOS/Linux:**\n```json\n{\n    \"mcpServers\": {\n        \"blender\": {\n            \"command\": \"uvx\",\n            \"args\": [\"--from\", \"git+https://github.com/anan0110692/blender-mcp-vse\", \"blender-mcp\"]\n        }\n    }\n}\n```\n\n**Windows:**\n```json\n{\n    \"mcpServers\": {\n        \"blender\": {\n            \"command\": \"cmd\",\n            \"args\": [\"/c\", \"uvx\", \"--from\", \"git+https://github.com/anan0110692/blender-mcp-vse\", \"blender-mcp\"]\n        }\n    }\n}\n```\n\n---\n\n## Usage\n\n### Enabling VSE Integration\n\n1. In Blender, open the **3D View sidebar** (press `N`)\n2. Find the **\"BlenderMCP\"** tab\n3. Check **\"Use Video Editing (VSE)\"** to enable video editing tools\n4. Click **\"Connect to Claude\"**\n\n### Example Commands\n\n#### Video Editing\n- *\"Import the video from E:\\Videos\\clip.mp4 and add it to the timeline\"*\n- *\"Cut the video at frame 100\"*\n- *\"Trim the first 2 seconds from the beginning of the clip\"*\n- *\"Add a cross-fade transition between the two clips\"*\n- *\"Reverse the video playback\"*\n- *\"Set the video to play at half speed\"*\n\n#### Audio\n- *\"Add background music from music.mp3 on channel 2\"*\n- *\"Set the audio volume to 50%\"*\n- *\"Mute the original video audio\"*\n\n#### Text & Graphics\n- *\"Add a title that says 'Welcome' at the beginning\"*\n- *\"Create a black color strip for 30 frames as an intro\"*\n- *\"Add a fade-in effect to the first clip\"*\n\n#### Export\n- *\"Set the output resolution to 1920x1080\"*\n- *\"Set the frame rate to 30 fps\"*\n- *\"Render the video as H.264 MP4\"*\n\n#### 3D + Video Workflow\n- *\"Create a 3D scene with a rotating cube, then render it as a video strip\"*\n- *\"Add the 3D render to the timeline and add music underneath\"*\n\n---\n\n## VSE Tools Reference\n\n### Media Import\n| Tool | Description |\n|------|-------------|\n| `add_movie_strip` | Add video file to timeline |\n| `add_sound_strip` | Add audio file to timeline |\n| `add_image_strip` | Add single image as strip |\n| `add_image_sequence` | Add image sequence as strip |\n| `add_scene_strip` | Add Blender scene as strip |\n| `add_color_strip` | Add solid color strip |\n| `add_text_strip` | Add text overlay strip |\n\n### Strip Editing\n| Tool | Description |\n|------|-------------|\n| `get_strip_info` | Get detailed strip information |\n| `move_strip` | Move strip to different position/channel |\n| `trim_strip` | Trim strip start/end points |\n| `cut_strip` | Split strip at specific frame |\n| `duplicate_strip` | Create copy of strip |\n| `delete_strip` | Remove strip from timeline |\n| `set_strip_properties` | Modify strip properties |\n\n### Effects & Transitions\n| Tool | Description |\n|------|-------------|\n| `add_transition` | Add transition between strips |\n| `add_effect_strip` | Add visual effect |\n| `add_adjustment_layer` | Add adjustment layer |\n| `add_speed_control` | Control playback speed/reverse |\n\n### Audio\n| Tool | Description |\n|------|-------------|\n| `set_strip_volume` | Adjust audio volume |\n| `set_strip_pan` | Adjust stereo panning |\n\n### Timeline\n| Tool | Description |\n|------|-------------|\n| `get_vse_info` | Get timeline overview |\n| `set_frame_current` | Jump to specific frame |\n| `set_frame_range` | Set start/end frames |\n| `set_preview_range` | Set preview range |\n| `get_strips_at_frame` | Find strips at frame |\n\n### Organization\n| Tool | Description |\n|------|-------------|\n| `make_meta_strip` | Group strips together |\n| `unmake_meta_strip` | Ungroup meta strip |\n| `select_strips` | Select specific strips |\n| `select_all_strips` | Select all strips |\n\n### Rendering\n| Tool | Description |\n|------|-------------|\n| `set_render_settings` | Configure output settings |\n| `render_animation` | Render video output |\n\n---\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `BLENDER_HOST` | `localhost` | Blender socket server host |\n| `BLENDER_PORT` | `9876` | Blender socket server port |\n| `DISABLE_TELEMETRY` | `false` | Disable anonymous telemetry |\n\n### Disabling Telemetry\n\n```json\n{\n    \"mcpServers\": {\n        \"blender\": {\n            \"command\": \"uvx\",\n            \"args\": [\"--from\", \"git+https://github.com/anan0110692/blender-mcp-vse\", \"blender-mcp\"],\n            \"env\": {\n                \"DISABLE_TELEMETRY\": \"true\"\n            }\n        }\n    }\n}\n```\n\n---\n\n## Compatibility\n\n- **Blender 4.x**: Full support\n- **Blender 5.x**: Full support (API compatibility layer included)\n- **Operating Systems**: Windows, macOS, Linux\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| VSE tools not appearing | Enable \"Use Video Editing (VSE)\" in the BlenderMCP panel |\n| Connection failed | Ensure Blender addon is running and connected |\n| Strip not found | Check strip name with `get_vse_info` |\n| Render fails | Verify output path is writable |\n| Audio not playing | Check if audio strip is muted |\n\n---\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues and pull requests.\n\n---\n\n## Credits\n\n- **Original BlenderMCP**: [Siddharth Ahuja](https://github.com/ahujasid/blender-mcp)\n- **VSE Extension**: [anan0110692](https://github.com/anan0110692)\n\n---\n\n## License\n\nMIT License - See [LICENSE](LICENSE) for details.\n\n---\n\n## Disclaimer\n\nThis is a community project and not officially affiliated with Blender Foundation or Anthropic.\n"}