Geometry Script: a Blender addon that gives Claude an API for node trees
Your next creation starts with a sentence. — free credits on sign-up Bring my idea to life
Blender's node trees are powerful, but they quickly become hard to read and reorganize as they grow. Geometry Script, an open-source addon, offers another route: describing nodes in Python code instead of wiring them by hand. The repository's author says the tool, originally built several years ago, turns out to suit coding agents like Claude particularly well, since they can manipulate Geometry Nodes and Shader Nodes through an API rather than through the graphical interface.
One caveat up front: the source provides no independent evaluation of the tool's real effectiveness. It is the GitHub repository documentation, and the observations below come from the author, not from third-party testing.
The idea: every node becomes a Python function
Geometry Script is a Python API for building Blender Geometry Nodes in code. Its core feature: every node in the installed Blender version is exposed as a typed Python function, generated directly from Blender. The editor can therefore autocomplete node names, inputs, outputs and enum values.
The resulting scripts are converted into standard Geometry Nodes trees, which remain editable in Blender. You do not leave the ecosystem: code is the construction method, the graph is the editable result.
The tool is not limited to Geometry Nodes. Shaders, materials, worlds and compositing groups can also be scripted through dedicated modules (shader and compositor).
Why a coding agent benefits
The author's argument is straightforward: node trees become unmanageable at large sizes, and code makes them easier to edit and reorganize. For a coding agent, the benefit is more structural. A typed API exposes function names and explicit inputs and outputs, reducing ambiguity compared with interface manipulation. The agent can generate, review and modify text, whereas a graphical interface requires visual actions that are hard to describe and verify.
The repository goes further by also presenting itself as a Claude Code plugin marketplace, with a skill dedicated to building node trees. That skill runs scripts through Blender's MCP server when connected, and otherwise in a background Blender instance. This is the most direct Claude link: the agent does not need to drive the interface; it produces code that the addon turns into a graph.
Installation: two paths
The extension requires Blender 5.2 or newer. Two methods are documented:
- Link-based install: drag the link matching your Blender version, allow online access and add the repository.
- Manual install: download a ZIP, then go to Preferences > Get Extensions > Install from Disk.
For the Claude Code skill, one version detail matters: on Claude Code versions earlier than 2.1.275, you must first add the marketplace. Beyond that, the flow is more direct.
Another technical point to know: node modules are not versioned. They are generated from Blender when the addon loads, or manually. A build script produces an installable package for a specific Blender version and runs a smoke test.
What to keep in mind
The source does not detail the API's practical limits, performance or failure cases. It also does not guarantee compatibility with future Blender or Claude Code versions. It is repository documentation, not third-party evaluation, and the claim about improved coding-agent efficiency remains the author's.
For a 3D creator, the tool's main value is methodological: it makes procedural graphs accessible to text-based writing, and therefore easier to version, review and hand to an assistant. It does not replace understanding nodes; it shifts part of the work toward code.
Quick comparison of the two workflows
| Criterion | Hand-built node tree | Via Geometry Script |
|---|---|---|
| Input | Graphical interface | Typed Python code |
| Readability on large graphs | Limited, per the author | Improved by code |
| Suited to a coding agent | Poorly | Yes, via API and skill |
| Output | Node tree | Editable node tree |
| Requirements | Blender | Blender 5.2+, addon |
Key takeaways
- Geometry Script turns each node into a typed Python function generated from Blender.
- Scripts become Geometry Nodes editable in Blender.
- Shaders, materials, worlds and compositing are also covered.
- A Claude Code skill exists, using an MCP server or a background Blender.
- Blender 5.2+ required; modules are generated on load and not versioned.
- No independent efficiency testing is provided: treat the promises with caution.
Source
Show HN: A Blender addon that makes Claude twice as efficient at using nodes
