blender_create_object
Create any object type in Blender—mesh, light, camera, curve, empty, armature, or text—and link it to a collection.
Instructions
Create a new object in the Blender scene. Supports mesh primitives, lights, cameras, curves, empties, armatures, and text objects. Automatically linked to the specified collection.
Use this when: you need to add a new object to the scene.
Do NOT use for: modifying existing objects (use blender_modify_object), adding modifiers (use blender_manage_modifier), assigning materials (use blender_manage_material).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name for the new object. | |
| object_type | No | Type of object to create. | MESH |
| primitive | No | Mesh primitive shape. Only for object_type=MESH. | |
| size | No | Size of mesh primitive in Blender units. | |
| segments | No | Segments for sphere/cylinder/cone/torus. | |
| light_type | No | Light type. Only for object_type=LIGHT. | POINT |
| energy | No | Light energy in watts. Only for LIGHT. | |
| color | No | Light color [r,g,b] range 0-1. Only for LIGHT. | |
| lens | No | Camera focal length in mm. Only for CAMERA. | |
| clip_start | No | Camera near clip. Only for CAMERA. | |
| clip_end | No | Camera far clip. Only for CAMERA. | |
| set_active_camera | No | Set as active scene camera. Only for CAMERA. | |
| curve_type | No | Spline type. Only for CURVE. | BEZIER |
| body | No | Text content. Only for TEXT. | |
| extrude | No | Extrude depth for TEXT. | |
| location | No | 3D position [x, y, z]. | |
| rotation | No | Euler rotation [x, y, z] in radians. | |
| scale | No | Scale [x, y, z]. | |
| collection | No | Collection to link to. Uses scene collection if omitted. |