blender-mcp-server

Get the position, rotation, and scale of a Blender object by name.

Get information about the current Blender scene including name, frame range, render engine, resolution, and object count.

Set the base color of a material. Color is [r, g, b] with values 0-1.

List known async Blender jobs with their IDs, statuses, and creation timestamps.

Set an image texture as the base color of a material. Provide the file path to the image.

Set the rotation of an object. Provide rotation as [x, y, z] angles. By default angles are in degrees.

Execute a Python script in Blender's context synchronously. Provide either 'code' (inline Python string) or 'script_path' (path to a .py file), not both. The script has access to 'bpy', 'mathutils', and an 'args' dict with your supplied arguments. Set '__result__' in the script to return a JSON-serializable value. Returns the result, captured stdout/stderr, and execution duration. Use transport='bridge' for the live Blender add-on session, or transport='headless' to run the script in a separate `blender -b` process. For long-running tasks like baking, use blender_python_exec_async.

Create a new mesh object in Blender. Supported types: cube, sphere, cylinder, plane, cone, torus.

Undo the last operation in Blender.

Export the scene as OBJ. Provide the output file path.

Assign an existing material to an object.

Create a new material. Optionally set an initial base color as [r, g, b] with values 0-1.

List all objects in the current Blender scene. Optionally filter by type (MESH, CAMERA, LIGHT, EMPTY, CURVE, etc.).

List all materials in the Blender file.

Move an object. Provide either 'location' for absolute positioning or 'offset' for relative movement.

Export the scene as FBX. Provide the output file path.

Get the status of an async Blender job. Returns job_id, status (queued/running/succeeded/failed/cancelled), timestamps, result, stdout, stderr, and error. Poll this after starting a job with blender_python_exec_async.

Start a long-running Python script in Blender asynchronously. Same parameters as blender_python_exec. Returns a job_id immediately. Use blender_job_status to poll for completion, and blender_job_cancel to abort. The script can check '__cancel_event__.is_set()' to detect cancellation. Ideal for fluid baking, rigid body simulation, or heavy scene generation. Use transport='headless' to run the job in a separate background Blender process.

Delete an object from the Blender scene by name.

Duplicate an object in the Blender scene. Optionally provide a new name.

Render the current scene as a still image. Optionally set output path, resolution, and render engine (BLENDER_EEVEE, CYCLES, etc.). Use transport='bridge' for the live Blender add-on session, or transport='headless' with blend_file='/path/to/file.blend' to render in a separate background Blender process.

Redo the last undone operation in Blender.

Set the scale of an object. Provide scale as [x, y, z].

Get the parent/child hierarchy of objects. If name is provided, returns the subtree for that object. Otherwise returns the full scene hierarchy.

Export the scene as glTF/GLB. Provide the output file path.

Cancel a running or queued async Blender job. The job's __cancel_event__ is set; scripts that check it will stop gracefully.

Render an animation. Optionally set output path, frame range, and render engine. Use transport='bridge' for the live Blender add-on session, or transport='headless' with a blend_file to render in a separate background Blender process.