PlugWiki
RhinoMCP logo

RhinoMCP: Control Rhino 3D and Grasshopper from Claude and Cursor

CommunityLocal

Lets Claude, Cursor and other assistants model in Rhino 3D and build Grasshopper definitions from plain-language requests.

RhinoMCP lets an assistant create and edit geometry in Rhino 8, read what is in your document, and build Grasshopper definitions. It is a community project by Jingcheng Chen. It runs on your computer: you add a plugin to Rhino, connect the server from your AI app, and type mcpstart in Rhino once per session. Know before you start that it can run Python, C# and Rhino commands in your open file, and it has no read-only mode.

Good for

  • Architects and designers who want to describe a model in words and have Rhino build it
  • Grasshopper users who want an assistant to find, place and wire components
  • Rhino users who script with Python or C# and want help writing and running it
  • Anyone on Rhino 8 for Windows or macOS who wants the assistant to see the viewport

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install RhinoMCP MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the RhinoMCP MCP server to Claude Code. Run this command:
    
    claude mcp add rhinomcp -- uvx rhinomcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires uv (Python), Rhino 8 + rhinomcp plugin, mcpstart running in Rhino.

Read-only mode: No read-only mode. Set RHINO_MCP_ENABLE_RUN_COMMAND, RHINO_MCP_ENABLE_RHINOSCRIPT and RHINO_MCP_ENABLE_CSHARP to 0 in the config to turn off the code tools.

Install the plugin first: in Rhino 8 open Tools, then Package Manager, search for rhinomcp, install, and restart Rhino. After your AI app connects, type mcpstart in the Rhino command line (once per Rhino session). The README uses rhinomcp@latest so the server updates each time your app starts it. The generated command here uses plain rhinomcp, which keeps the first version it downloaded. Run only one RhinoMCP server at a time.

Built from the package data we hold. Not yet tested by us.

Tools

  • Gives a quick summary of the open Rhino document

    Returns a light overview of the current file so the assistant knows what is in it before it changes anything.

    Try: “What is in my Rhino file right now?”

    Read · get_document_summary

  • Lists objects in the document with filters and paging

    Queries the objects in the open document, with filters and paging so large models do not flood the chat.

    Try: “List all the curves on the Walls layer.”

    Read · get_objects

  • Shows details for one object

    Returns an object's id, name, type, custom attributes and geometry details. You give it an id or a name.

    Try: “Tell me everything about the object named "roof".”

    Read · get_object_info

  • Describes what you have selected in Rhino

    Returns the same detail as the single-object lookup, but for whatever is selected right now.

    Try: “Describe the objects I have selected.”

    Read · get_selected_objects_info

  • Selects objects by name, color or category

    Selects objects in the document using filters such as name, color or category, combined with AND or OR.

    Try: “Select every red object on the Furniture layer.”

    Write · select_objects

  • Reads an object's name, layer and custom notes

    Returns light metadata for an object plus its custom user strings.

    Try: “What user strings are set on the selected object?”

    Read · get_object_attributes

  • Edits an object's name, layer and custom notes

    Changes object metadata and custom user strings without touching its geometry.

    Try: “Add a user string "material=oak" to the table.”

    Write · update_object_attributes

  • Creates one shape in Rhino

    Creates a single object such as a point, line, box, sphere, cylinder or curve in the open document.

    Try: “Draw a box 4 by 2 by 1 at the origin.”

    Write · create_object

  • Creates many shapes in one go

    Creates several objects in a single call, which is faster than adding them one at a time.

    Try: “Create a 5 by 5 grid of spheres, 2 units apart.”

    Write · create_objects

  • Moves, rotates, scales or recolors one object

    Applies a transform, color or visibility change to an existing object chosen by id or name.

    Try: “Rotate the selected box 90 degrees around the Z axis.”

    Write · modify_object

  • Edits many objects at once

    Applies color, move, rotate, scale or visibility changes to a list of objects, or to all objects at once. Its built-in help text is a copy of the create tool's.

    Try: “Turn every sphere blue.”

    Write · modify_objects

  • Deletes an object from the document

    Removes an object from the Rhino document. It is marked destructive.

    Try: “Delete the object named "temp_box".”

    Delete · delete_object

Read from the source code

Permissions

high risk · 4 things to watch

High risk

The assistant can run scripts, C# code and commands inside your open Rhino session, and it can delete objects, layers and Grasshopper parts. Switch off the three code and command tools with the settings listed under the findings, and work on a copy of your file.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can run code and commands inside Rhino

    Three tools run a Rhino command, RhinoScript Python or RhinoCommon C# in your open session, and all three are on by default. Set RHINO_MCP_ENABLE_RUN_COMMAND, RHINO_MCP_ENABLE_RHINOSCRIPT and RHINO_MCP_ENABLE_CSHARP to 0 in the config if you do not need them. github.com

  • It can delete objects, layers and canvas parts

    Tools delete objects and layers, and clear Grasshopper components or whole graphs. Undo and redo tools exist, but save a copy of your file first. github.com

  • The link to Rhino has no password

    The server and plugin talk over an unauthenticated TCP link on 127.0.0.1:1999. Keep it on the local machine, as the README says, and never expose that port. github.com

  • Only one server at a time

    The README says to run one RhinoMCP server at a time, not one per AI app. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only switch. RHINO_MCP_ENABLE_RUN_COMMAND, RHINO_MCP_ENABLE_RHINOSCRIPT and RHINO_MCP_ENABLE_CSHARP set to 0 turn off the command, Python and C# tools, but modeling and delete tools stay.
Talks toLocal link from the server to the Rhino plugin on 127.0.0.1, port 1999 by default
Sign-in and keysNo account or API key.

Questions

Is RhinoMCP official?

No. It is a community project by Jingcheng Chen, not made by McNeel, the maker of Rhino. It is MIT licensed.

Which version of Rhino does it need?

Rhino 8 on Windows or macOS. You also install the rhinomcp plugin through Rhino's Package Manager and type mcpstart in the command line once per session.

Does it need an API key or account?

No. The server talks to your local Rhino plugin and needs no sign-in.

Can it run read-only?

No. There is no read-only mode. You can turn off the command, Python and C# tools with three environment variables set to 0, but modeling and delete tools stay on.

Does it work with ChatGPT?

Not directly. ChatGPT apps connect to remote servers, not local commands like uvx rhinomcp, so the project points to Codex for local use.

Does it work with Grasshopper?

Yes. With Rhino open and mcpstart running, the assistant can open or create a Grasshopper document, place and wire components, set sliders and solve.

Can it undo what it did?

Mostly. There are undo and redo tools, but code or commands it runs can change things in ways undo may not cover, so save a copy first.

How do I add it to Claude or Cursor?

Use the install box above for your app, after installing the Rhino plugin. The server runs with uv, so install uv first.

Information

updated Nov 2, 2026

Publisher
Community
Package
rhinomcp
Registry
PyPI
Transport
stdio
Auth
None
License
MIT
Last commit
Oct 16, 2026
Open issues
8

GitHubChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. github.com · github.com
  2. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.