What is Geometry Script?
Geometry Script is a Python API for creating Blender Geometry Nodes with code, aimed at people who need to build or reorganize node trees. It also supports scripting shader node groups, materials, worlds, and compositor node groups. Scripts are converted into Blender node trees, so the result can be adjusted in Blender by people who may not be familiar with scripting. The extension requires Blender 5.2 or newer.
Geometry Script Features:
Geometry Nodes API: Write Python functions to create Geometry Nodes trees, including operations that build meshes, convert them to points, and instance geometry.
Typed Node Functions: Use generated Python functions for every node in your Blender version, with types for node names, inputs, outputs, and enum values.
Shader Scripting: Create shader node groups and materials in Python, including material setups built with shader nodes such as Principled BSDF.
World Scripting: Use the shader API to script Blender worlds as well as materials and shader node groups.
Compositor Scripting: Build compositor node groups through the compositor API using the same code-based approach as Geometry Nodes.
Claude Code Skill: Install a Claude Code skill for building node trees, which runs scripts through Blender's MCP server when connected or through background Blender.
Geometry Script Benefits:
Easier Tree Editing: Reworking a large node tree in code can make changes and reorganization more manageable than working through an unwieldy node layout.
Clearer Handoff: Because scripts become editable Blender node trees, collaborators can inspect and tweak the result without needing to write the original code.
Faster Node Lookup: Editor completions for node names and sockets help reduce guesswork when writing scripts against Blender's available nodes.
Consistent Workflows: Using one code-based approach across geometry, materials, worlds, and compositor groups keeps related procedural work in a familiar format.
Code-Assisted Creation: The scripting workflow lets users generate and revise node structures with code rather than building every connection manually in the node editor.
Use Cases:
Complex Node Trees: Create or reorganize a large Geometry Nodes setup when its visual layout has become difficult to manage.
Procedural Repetition: Write a reusable function that places instances across a grid or another point-based arrangement.
Material Authoring: Script material node setups, such as a gold-colored Principled BSDF material, and adjust their values in code.
World Setup: Build a Blender world using the shader API when a project needs a scripted world node setup.
Compositor Groups: Create compositor node groups through Python as part of a code-driven Blender workflow.
AI-Assisted Node Trees: Use the Claude Code skill to help build Geometry Script node trees through Blender's MCP server or background Blender.

