Using a developer access token for authentication
If you are using Speckle for Grasshopper in a headless Rhino environment such as Rhino Compute, or you want access to a Speckle account via developer access token, you can use the Speckle Model URL with Token node from the Dev category.
The developer token used must have the following scopes enabled:
profile:read, profile:email,
stream:read, and workspace:read (unless on a non-workspace enabled server), as well as any
other write scopes needed- Add the Speckle URL input to the Speckle Model you want to create a resource for.
- Add the Speckle Token input string of your developer access token. Tokens can be created in the Speckle app with your desired permissions.
- The Speckle Model output contains the Model resource of your input URL.
Inspecting all attributes on Speckle params
Use the Deconstruct node to access every field of a Speckle param in Grasshopper, such as its application ID, geometric attributes like the knot vector of a NURBS curve, and any dynamically attached attributes. To find what an object is connected to, such as its level, rooms, or host, use the Explore node instead. In the web app, the Inspector panel shows the relations and raw properties of a selected object.Inspect → construct → exchange: Deconstruct is the inspect layer (one object on a wire).
To construct rich graphs with computed metadata and nested collections in C#, see Enrich
Speckle data in
Grasshopper. Publish on
the connector is the exchange layer when you are ready to move data.

- Add a Speckle Param input of any Speckle parameter you would like to inspect.
- An output will be created for every direct attribute on the input Speckle Param.
Right-click an output param for additional settings:
- Select extract parameter to automatically create a new param node with the value and name of the output param.
Synchronous operations
For any scripts operating in contexts which require synchronous solving of nodes, use the (Sync) Publish and (Sync) Load nodes instead of the default Publish and Load nodes.Using Speckle with C#/Python script nodes
C# script
Speckle publishes nuget packages for our C# SDK. You will need to install the following nugets for your custom C# script:- Use the Speckle.Sdk nuget for publish and load operations, serialization, core objects classes like Base and Collection, and more.
- Use the Speckle.Objects nuget for access to all geometry and additional object classes.

- Add a C# script node from Maths > Script, and double-click it to open the script editor.
- Select the box icon to install a third-party package.
- Paste these references into the Specify Package(s) field and select Install.
Python script
The Python SDK, specklepy, needs Python 3.11 or later. Whether you can use it inside Grasshopper depends on the Rhino runtime:- Rhino 8: its Python 3 engine is CPython 3.9.11, below specklepy’s minimum. Use the C# route above or run specklepy in a separate Python environment. See What is Rhino.Python?.
- Rhino 9 WIP: its new Python 3 ScriptEditor uses CPython 3.13.4 under
~/.rhinocode/py313-rh9, so it can run current specklepy. Use the new Python 3 Script component; scripts marked#! python3or saved with a.py3extension use that runtime. See McNeel’s Python 3.13 announcement and Rhino 9 WIP runtime report. - Legacy GhPython: the old component uses IronPython 2.7 and cannot run current specklepy. It is separate from the new ScriptEditor components. See Grasshopper scripting with Python.