MCP for Blender
Menu Changelog

Reference

MCP for Blender Changelog

Release history for MCP for Blender including new integrations, bug fixes, and protocol changes.

This changelog tracks notable changes to MCP for Blender. For the full commit history, see the GitHub repository.

This page is maintained by the project team. For the most current release notes, check the GitHub releases page and PyPI.

Recent Changes

One-command updates

uvx mcp-for-blender@latest update updates the MCP server and every installed copy of the Blender addon in one step, keeping a .bak of each replaced file. Add --dry-run to preview the changes. See Upgrading.

Simpler tools and workflow guides

The AI now writes Blender Python itself for modelling, layout, materials, animation, rigging and retopology, and the MCP keeps only the tools for what Python can't do. See the Tools overview.

  • look: See the scene as a multi-angle sheet, through the camera, as topology or rig views with stats, or as an animation strip. Replaces get_viewport_screenshot.
  • generate_3d: One call to generate and import a model with Tripo, Hunyuan3D or Hyper3D Rodin. Premium generators are used first automatically.
  • search_assets / import_asset: One pair of tools for Poly Haven, Sketchfab and Poly Pizza. Poly Haven textures can be applied to objects in the same call.
  • get_guide: Workflow guides for bpy, scene building, level design, animation, rigging, retopology and materials, loaded only when needed and also available as guide:// resources.
  • get_scene_info: Now a compact summary, one line per object, with root and query to drill in.

If your prompts or scripts call tools by name, here's what replaced them:

Old tools Now
get_viewport_screenshot look
get_object_info get_scene_info(root=...) or execute_blender_code
search_polyhaven_assets, get_polyhaven_categories, get_polyhaven_asset_preview, search_sketchfab_models, get_sketchfab_model_preview, search_polypizza_models search_assets
download_polyhaven_asset, set_texture, download_sketchfab_model, download_polypizza_model import_asset
generate_hyper3d_model_via_text, generate_hyper3d_model_via_images, generate_hunyuan3d_model, generate_tripo_model, and their poll_* and import_generated_asset* tools generate_3d
export_scene, describe_node_type, bpy_api_lookup execute_blender_code

2.1

  • One-command install: curl -LsSf https://www.mcp-for-blender.com/install.sh | sh (or uvx mcp-for-blender setup) configures your MCP clients and installs and enables the Blender addon. See Installation.
  • Codex plugin: A live viewport in the chat, thumbnail asset pickers, and @-mentions for scene objects. See Codex Plugin.
  • Addon updates in Blender: The addon checks for a new version on startup and can update itself from the sidebar.

2.0

  • Renamed to mcp-for-blender: The PyPI package blender-mcp is now mcp-for-blender. Existing setups keep working (uvx blender-mcp still runs the server) and no config change is required, but new installs should use mcp-for-blender. See the announcement.
  • Safe mode: Set BLENDER_MCP_SAFE_MODE=1 to check every script before it runs in Blender and block risky code.
  • Scene export: export_scene exports the scene, the selection, or named objects to GLB/FBX.
  • API lookups: describe_node_type and bpy_api_lookup let the AI read node schemas and the bpy API reference instead of guessing socket order or enum names.
  • Connection flags: --host and --port CLI flags for running several Blender instances side by side.
  • Docker image: Run the MCP server in a container while Blender runs on your machine.
  • Poly Pizza integration: Import low-poly models directly from the Poly Pizza library of over 10,600 free assets.
  • Hunyuan3D integration: Generate 3D models from text or images using Tencent's Hunyuan3D, including International (Pro) Tencent Cloud accounts.
  • Addon version handshake: The MCP server checks the installed addon's version on connect and logs how to update it if it is behind.
  • Persistent credentials: API keys for Sketchfab, Poly Pizza, Hyper3D Rodin, and Hunyuan3D are saved in Blender's Add-on Preferences and survive restarts.