Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Design - official Blender server

Blender MCP server

A lightweight MCP server from Blender Lab that connects an LLM client to a running Blender session through a companion add-on, exposing the Python API, bundled manual and API docs, scene summaries, screenshots and code execution. It runs locally and needs no auth.

Last verified 15 tools7 sources

Install

Generic

JSON
{
	"mcpServers": {
		"blender": {
			"command": "uv",
			"args": [
				"--directory",
				"$HOME/blender_mcp/mcp",
				"run",
				"blender-mcp"
			]
		}
	}
}

Tools

execute_blender_code
Execute Python code in the connected Blender instance.
execute_blender_code_for_cli
Execute Python code in a background Blender process.
get_blendfile_summary_datablocks
Return a summary of the blend file: data-block counts, active workspace, and render engine.
get_blendfile_summary_missing_files
Report external file references that are missing from disk.
get_blendfile_summary_of_linked_libraries
Return a tree of directly and indirectly linked library files.
get_blendfile_summary_path_info
Fast access to the blend file's path, save status, age, and backups.
get_blendfile_summary_usage_guess
Guess the primary use-cases of the current blend file (scored 0-100 with certainty).
get_object_detail_summary
Return a structured summary of the object identified by name.
get_objects_summary
Return the scene's collection hierarchy and their objects.
get_python_api_docs
Return the Blender Python API docs for an identifier, or list modules matching a discovery pattern.
get_screenshot_of_window_as_image
Take a screenshot of the entire Blender window and return it as a PNG image.
jump_to_view3d_object_by_name
Move the 3D viewport to focus on an object by name.
render_viewport_to_path
Render the current scene to output_path using current render settings.
search_api_docs
Full-text search over the bundled Blender Python API reference.
search_manual_docs
Full-text search over the bundled Blender user manual.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Blender Lab project (Blender Foundation's experimental innovation space); no beta/GA label is used.
  • Requires Blender 5.1 or newer plus the MCP add-on (v1.0.3, released 2026-09-11).
  • Installed from source with uv or as an .mcpb bundle from the release page; no npm/PyPI package.
  • Streamable HTTP is available via '--transport http --port 9191' (documented for llama.cpp).
  • Vendor security warning: the server executes LLM-generated code in Blender without guards; a VM or isolated system is recommended.
  • Windows config uses C:\\blender_mcp\\mcp as the directory.

More MCP servers for design

Related reading

FAQ

What does the Blender MCP server do?

A lightweight MCP server from Blender Lab that connects an LLM client to a running Blender session through a companion add-on, exposing the Python API, bundled manual and API docs, scene summaries, screenshots and code execution. The vendor documents 15 tools, including execute_blender_code, execute_blender_code_for_cli, get_blendfile_summary_datablocks and get_blendfile_summary_missing_files.

How do I add the Blender MCP server to an MCP client?

Blender documents a Generic config; copy it from the Generic section of this page.

Does the Blender MCP server need authentication?

No. The vendor documents it as needing no auth. Transport: stdio, Streamable HTTP. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 7 Blender pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.