Skip to directory

About Blender Lab MCP

Blender Lab local MCP connects an MCP client to a Blender session and Python API through an add-on and TCP bridge.

What you can use it for

  • Inspect and analyze the current Blender scene.
  • Use natural language to interact with Blender and its Python API/documentation.
Connection and setup
Hosting
Local MCP server
Transport
stdio
Endpoint
Local process; no hosted endpoint documented
Authentication
Requires a compatible local Blender version and installed/enabled Blender Lab add-on; the official source repository was inaccessible to this pass, so no tool names are asserted.

Requirements

  • Blender 5.1 or newer
  • Blender Lab MCP add-on
  • MCP-compatible client
  • MCP server bundle or source setup

Setup steps

  1. Install Blender 5.1 or newer from the official Blender download page.
  2. On the official Blender MCP page, install the Blender Lab MCP add-on. The documented drag-and-drop method adds the Blender Lab repository first and then installs the add-on; the page also documents Install from Disk.
  3. Install or select an MCP-compatible LLM client.
  4. For a client that supports MCP Bundles, download the current .mcpb package from the official Blender MCP release page and install it in the client. Blender documents that Llama.cpp does not support this bundle method; use the client-specific source setup linked from Blender’s MCP page instead.
  5. Start/configure the MCP server using the selected client’s official setup flow, then connect it to the Blender session with the installed add-on.
  6. Inspect the available tools before use. Begin with a harmless scene inspection in a disposable project.
  7. Treat all generated-code execution as untrusted: use a virtual machine or a system without sensitive files, credentials, or data.
Tools 20

20 identifiers taken from the active modules in Blender Lab blender_mcp main branch. The server auto-discovers tool modules at startup; identifiers and availability can change with source revision and Blender/add-on state.

  • execute_blender_code

    Execute Python code in the running Blender instance.

    01
  • get_blendfile_summary_datablocks

    Summarize data-blocks in the current Blender file.

    02
  • get_blendfile_summary_missing_files

    Report missing external files referenced by the Blender file.

    03
  • get_blendfile_summary_of_linked_libraries

    Summarize linked libraries used by the Blender file.

    04
  • get_blendfile_summary_path_info

    Summarize file and path information for the current Blender project.

    05
  • get_blendfile_summary_usage_guess

    Estimate the likely purpose or usage of the current Blender file.

    06
  • get_object_detail_summary

    Return detailed information about a Blender object.

    07
  • get_objects_summary

    Summarize objects in the current Blender scene.

    08
  • get_python_api_docs

    Retrieve Blender Python API documentation.

    09
  • get_screenshot_of_area_as_image

    Capture a Blender area as an image.

    10
  • get_screenshot_of_window_as_image

    Capture the Blender window as an image.

    11
  • get_screenshot_of_window_as_json

    Capture window state as structured JSON.

    12
  • jump_to_tab_by_name

    Switch Blender to a named workspace or tab.

    13
  • jump_to_tab_by_space_type

    Switch to a workspace matching a Blender editor type.

    14
  • jump_to_view3d_object_by_name

    Focus the 3D view on a named object.

    15
  • jump_to_view3d_object_data_by_name

    Focus the 3D view on data belonging to a named object.

    16
  • render_thumbnail_to_path

    Render a thumbnail and save it to a path.

    17
  • render_viewport_to_path

    Render the Blender viewport to a path.

    18
  • search_api_docs

    Search Blender Python API documentation.

    19
  • search_manual_docs

    Search the Blender user manual.

    20
Limitations and notes
  • The publisher warns that generated code runs inside Blender without safeguards and may delete data or send it remotely. Use an isolated environment for untrusted prompts.
Original sources
  • official brand reference

    Blender Foundation identifies the Blender logo as its registered property and provides usage conditions. A local logo asset has not yet been collected or visually approved.

  • official publisher repository

    Blender’s official Lab MCP page and repository identify the local add-on/server architecture; the project repository could not be accessed to inspect its full tool reference.

  • official documentation

    Official Blender Lab page documents local Blender 5.1+ add-on plus MCP bundle/server, Python API access, scene analysis and an explicit warning that generated code executes without safeguards; no exact roster is published on this page.

Documentation checked 2026-10-28T18:15:00.000Z. Connection has not been runtime tested.