A practical Claude and Blender 2.5D animation workflow starts by choosing the right connector, then placing flat character artwork in a 3D scene. Blender renders the scene; Claude can work with it through a connector, but the setup requirements depend on which connector you choose.
What you need before you start
Prepare the character artwork you want to use, a Blender project, and a Claude-to-Blender connection. For still poses or facial expressions, separate image files can work as individual planes. For changing poses, use a numbered image sequence that Blender can import as animation.
Choose the connection before installing anything. The official Blender connector and the separate community project MCP for Blender have different prerequisites:
| Connector | Documented prerequisites | Practical distinction |
| Official Blender connector | Claude Desktop and Blender 4.2 or later; any Claude plan, including Free | The Blender developers’ connector works with the open scene through Blender’s Python API. Changes reach the project file when you save it. |
| MCP for Blender | Blender 3.0 or later, Python 3.10 or later, and uv | A separate community project. Its README lists a Claude Code setup command and describes its own security controls. |
Claude Academy’s official connector instructions describe the official route. The community project’s current package is named mcp-for-blender; its README gives these setup commands:
claude mcp add blender uvx mcp-for-blender
uvx mcp-for-blender install-addon
One creator walkthrough shows a Claude connection and prompt-driven edits using Blender 5.2 and Claude’s Free plan. That is an example setup, not a universal version requirement.
Set a security boundary for the community connector
MCP for Blender can run arbitrary Python code inside Blender by default. Its optional BLENDER_MCP_SAFE_MODE=1 setting checks scripts and blocks direct file access, external programs, network access, and persistent code, while retaining tasks such as modeling, rendering, saving, and import/export. The project’s README also says its socket server has no authentication or encryption. Keep it on localhost unless you are using a trusted network; for remote access, the project recommends an SSH tunnel.
That network boundary is separate from safe mode. Enabling safe mode does not add authentication or encryption to the socket server.
Build the animation in Blender
- Choose a story and plan the shots. Write down what happens and what each shot needs to show. A shot list gives you a concrete scope for the scene and for the changes you ask Claude to make.
- Connect Claude to the open Blender scene. Use the setup for your chosen connector, then ask for a specific scene change at a time. Blender’s official connector uses the Python API to work with the open scene; Blender still renders the scene, and you need to save the project to keep changes.
- Block out the 3D environment. Place the main objects and camera before refining the look. This lets you assess the composition with the character planes in place rather than polishing a set that may not fit the shot.
- Import the character artwork as planes. In Blender, use 3D Viewport > Add > Image > Mesh Plane. The operator can create a plane from one image, multiple images, an image sequence, or a movie clip. For numbered frames, Detect Image Sequences can import them as an animated sequence; Blender sets the frame range automatically, and you can adjust it afterward. See the Blender manual’s Mesh Plane instructions.
- Choose how the artwork responds to light. Blender documents Principled, Shadeless, and Emission material options. Shadeless materials do not respond to scene lighting; with Emission, the image texture connects to the material’s Emission input. Use the option that fits the look you want for the flat artwork.
- Set the plane’s orientation and refine the scene. The import operator includes Face Camera and Camera’s Main Axis alignment options. These can add a Locked Track constraint, which keeps the plane oriented toward the camera. Then adjust the scene’s lighting and framing for the shot.
- Review the animation and make focused revisions. Check that the artwork appears as intended, numbered frames change at the right points, and camera movement and lighting work in the rendered scene. Ask Claude for a specific correction, inspect the result in Blender, and save the project when it is right.
- Check the exported video. Play the finished file from beginning to end and confirm that its scenes, image changes, and sound match your intended sequence.
Decide which connector is handling the scene before asking Claude for edits; then check each change in Blender and save the project you want to keep.
Mistakes that can derail the workflow
- Applying one connector’s requirements to the other. Blender 4.2 or later applies to the official connector described by Claude Academy; MCP for Blender lists Blender 3.0 or later, Python 3.10 or later, and
uvfor its own setup. - Treating scene control as final video generation. The connector gives Claude access to Blender scene data. Blender renders the scene, and the finished video still needs a review and export check.
- Assuming safe mode secures the network connection. Safe mode restricts certain code operations. The community connector’s socket server still lacks authentication and encryption.
- Using unnumbered files when you want automatic sequence detection. Blender’s sequence option is for sequentially numbered image files; its frame range can be adjusted after import.