blender_animation
Animate objects and characters in Blender using keyframes, shape keys, actions, constraints, and baking for export.
Instructions
PORTMANTEAU PATTERN RATIONALE: Consolidates 17 related animation operations into single interface. Prevents tool explosion while maintaining full animation workflow functionality from basic keyframes to advanced character rigging. Follows FastMCP 2.14.3 best practices.
Comprehensive animation system for Blender supporting keyframes, shape keys, actions, constraints, and baking.
Animation Categories:
Basic Animation (7 operations):
set_keyframe: Insert keyframes for location/rotation/scale at specific frames
animate_location: Create movement animation between start/end frames
animate_rotation: Create rotation animation with customizable curves
animate_scale: Create scale animation with interpolation control
play_animation: Start/stop viewport playback for preview
set_frame_range: Define timeline start/end frames for scene
clear_animation: Remove all keyframes from object (destructive)
Shape Keys (VRM facial expressions) (4 operations):
list_shape_keys: Display all morph targets on mesh object
set_shape_key: Set blend value (0.0-1.0) for shape key
keyframe_shape_key: Insert keyframe for shape key animation
create_shape_key: Create new shape key from current mesh state
Action Management (4 operations):
list_actions: Show all animation actions in blend file
create_action: Generate new action clip for object animation
set_active_action: Assign action to object for playback
push_to_nla: Push action to NLA track for layering/compositing
Interpolation & Timing (2 operations):
set_interpolation: Set keyframe interpolation type (LINEAR, BEZIER, BOUNCE, ELASTIC, CONSTANT)
set_easing: Configure easing curves (AUTO, EASE_IN, EASE_OUT, EASE_IN_OUT)
Constraints (2 operations):
add_constraint: Add transform constraints to objects
add_bone_constraint: Add pose constraints to armature bones
Baking for Export (2 operations):
bake_action: Convert constraints to keyframes for export compatibility
bake_all_actions: Consolidate NLA strips into single action
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | No | The animation operation to perform. Must be one of: "set_keyframe", "animate_location", "animate_rotation", "animate_scale", "play_animation", "set_frame_range", "clear_animation", "list_shape_keys", "set_shape_key", "keyframe_shape_key", "create_shape_key", "list_actions", "create_action", "set_active_action", "push_to_nla", "set_interpolation", "set_easing", "add_constraint", "add_bone_constraint", "bake_action", "bake_all_actions". - Basic operations: "set_keyframe", "animate_*", "play_animation", "set_frame_range", "clear_animation" - Shape key operations: "list_shape_keys", "set_shape_key", "keyframe_shape_key", "create_shape_key" - Action operations: "list_actions", "create_action", "set_active_action", "push_to_nla" - Interpolation: "set_interpolation", "set_easing" - Constraints: "add_constraint", "add_bone_constraint" - Baking: "bake_action", "bake_all_actions" | set_keyframe |
| object_name | No | Target object name for animation operations. Required for most operations. | |
| armature_name | No | Target armature name for bone-specific operations. Required for: "add_bone_constraint", bone targeting in constraints. | |
| bone_name | No | Target bone name within armature for pose operations. Required for: "add_bone_constraint", bone targeting in constraints. | |
| frame | No | Frame number for keyframe insertion. Default: 1. Range: 1 to 10000. | |
| start_frame | No | Starting frame for animation ranges. Default: 1. Must be < end_frame. | |
| end_frame | No | Ending frame for animation ranges. Default: 60. Must be > start_frame. | |
| location | No | Target location coordinates (x, y, z) for keyframes. Required for: "set_keyframe" (location), "animate_location". | |
| rotation | No | Target rotation values (degrees) for keyframes. Required for: "set_keyframe" (rotation), "animate_rotation". | |
| scale | No | Target scale factors (x, y, z) for keyframes. Required for: "set_keyframe" (scale), "animate_scale". | |
| start_location | No | Starting location for animation. Default: (0, 0, 0). | |
| end_location | No | Ending location for animation. Default: (5, 0, 0). | |
| start_rotation | No | Starting rotation for animation. Default: (0, 0, 0). | |
| end_rotation | No | Ending rotation for animation. Default: (360, 0, 0). | |
| start_scale | No | Starting scale for animation. Default: (1, 1, 1). | |
| end_scale | No | Ending scale for animation. Default: (2, 2, 2). | |
| shape_key_name | No | Name of shape key for morph operations. Required for: "set_shape_key", "keyframe_shape_key", "create_shape_key". | |
| value | No | Shape key blend value. Range: 0.0 to 1.0. Default: 1.0. Required for: "set_shape_key", "keyframe_shape_key". | |
| from_mix | No | Whether to create shape key from current mix. Default: False. | |
| action_name | No | Name for new or existing action. Required for: "create_action", "set_active_action", "push_to_nla". | |
| track_name | No | NLA track name for action placement. Default: auto-generated. | |
| interpolation | No | Keyframe interpolation type. One of: "CONSTANT", "LINEAR", "BEZIER", "SINE", "QUAD", "CUBIC", "QUART", "QUINT", "EXPO", "CIRC", "BACK", "BOUNCE", "ELASTIC". Default: "BEZIER". | BEZIER |
| easing | No | Keyframe easing mode. One of: "AUTO", "EASE_IN", "EASE_OUT", "EASE_IN_OUT". Default: "AUTO". | AUTO |
| data_path | No | FCurve data path for interpolation operations. Default: auto-detected. | |
| constraint_type | No | Type of constraint to add. One of: "COPY_ROTATION", "COPY_LOCATION", "COPY_SCALE", "TRACK_TO", "DAMPED_TRACK", "LOCKED_TRACK", "STRETCH_TO", "CLAMP_TO", "TRANSFORM", "CHILD_OF". Default: "COPY_ROTATION". | COPY_ROTATION |
| target_name | No | Name of target object for constraint. Required for all constraint operations. | |
| target_armature | No | Name of target armature for bone constraints. | |
| target_bone | No | Name of target bone for bone constraints. | |
| influence | No | Constraint influence factor. Range: 0.0 to 1.0. Default: 1.0. | |
| visual_keying | No | Include visual transforms in baking. Default: True. | |
| clear_constraints | No | Remove constraints after baking. Default: False. | |
| bake_types | No | Types of data to bake. One of: "POSE", "OBJECT", "ALL". Default: "POSE". | POSE |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |