SkillFoxx

Supex MCP

An MCP server and extension for SketchUp: an agent runs Ruby scripts in a model, inspects the scene and exports the result.

  • 60 ★ on the repository
  • Last commit
MCP server

Broad access

Why this level

  • An agent runs arbitrary Ruby inside SketchUp with access to model files and the system.
  • The project is experimental and runs on macOS with the latest SketchUp.
All reasons and checks

darwin/supexAuthor:darwin

Install

Manual install

git clone --recurse-submodules https://github.com/darwin/supex.git

README step 1; then `./scripts/launch-sketchup.sh` and server registration through `claude mcp add`. VCAD needs `./scripts/rebuild.sh`.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • An agent runs arbitrary Ruby inside SketchUp with access to model files and the system.
  • The project is experimental and runs on macOS with the latest SketchUp.

This is third-party code. Review the repository files before installing.

What it does

Supex connects Claude Code to SketchUp. An agent runs any code on the SketchUp Ruby API, inline or from project scripts, and the MCP server returns model inspection: entities, screenshots, materials, camera and statistics. Scripts live in git, so the work has history and editor highlighting. Export covers SKP, OBJ, STL, PNG and JPG. A separate part, VCAD, adds parametric modeling on a BRep kernel. An agent writes geometry in the Loon language, a Rust sidecar evaluates solids from it and SketchUp imports the mesh as a native component. Boolean operations, fillet, chamfer, shell, extrude, revolve, sweep and patterns are available.

Who it is for. Programmers and modelers who want to describe a 15-step staircase, parametric parts and repetitive geometry in SketchUp in plain words.

Good fit when

  • You need a staircase or another parametric structure that is awkward to draw by hand.
  • A model must be surveyed: entities, materials, camera and statistics in one request.
  • A home renovation project lives in git and needs a history of modeling scripts.
  • You need a solid from a BRep kernel imported into SketchUp as a component.

Not a fit when

  • You need a quick sketch of an idea: the manual SketchUp interface suits that better.
  • You are not on macOS: the platform is tested only there.
  • You need support for older SketchUp versions: only the latest is tested and compatibility is not promised.

Example request

Create a 15-step staircase in SketchUp from the script parameters, show a screenshot and export the model to SKP.

MCP

Transport
stdio
Authentication
not required

Limitations

The project is early and experimental: tested only on macOS with Claude Code and the latest SketchUp 2026, and the author promises no backward compatibility. Python 3.14 or newer through uv and Ruby 3.2.2 are needed, a pin tied to SketchUp that is long past end of life. VCAD also needs Rust and Node.js, and building the sidecar takes time. The repository is cloned with submodules, otherwise vendored VCAD dependencies will not load. Stable releases sit in `main` while active development happens on the `dev` branch.

How to disable. Remove the `supex` entry from the project `.mcp.json` and the `supex-guide` symlink. Delete the extension from the SketchUp extensions folder and remove the cloned repository.

FAQ

How do I connect Supex to Claude Code?

In your project run `claude mcp add --scope project --transport stdio supex -- /path/to/supex/mcp`. Then link the guide with `ln -s /path/to/supex/docs/agents/guide supex-guide` and reference `supex-guide/README.md` from `CLAUDE.md`.

How do I launch SketchUp with the extension?

With `./scripts/launch-sketchup.sh path/to/model.skp`. The script starts SketchUp, deploys extension sources with no `.rbz` build and enables live reloading.

What is VCAD?

A parametric CAD kernel on BRep: geometry is written in Loon, a Rust sidecar builds solids and SketchUp imports the result as a component. The part is optional and built separately.

How do I check the link to SketchUp?

Run `./supex status`: the command shows the connection state and the SketchUp version.

Where can I find an example?

Examples live in separate branches. Get the table example with `git clone -b example-simple-table https://github.com/darwin/supex.git simple-table`.

Discussion

No questions or reviews yet.

MCP servers

MCP server and skill for SketchUp: an agent builds an editable 3D model from photos, CAD or text and checks it against the source.

MCP serverExtended access102

An MCP server for Autodesk 3ds Max: the agent reads the scene, models, and sets up materials and modifiers

MCP serverBroad access381

An Excalidraw MCP server: the agent draws a diagram and adds keyframe animation while you watch it assemble live in the browser

MCP serverExtended access100

Blender Agent Studio builds models and scenes in Blender from a description: a .blend file, Python source and checked renders.

PluginExtended access111

Blender MCP: an agent in Cursor, Cline, Windsurf or Claude Desktop builds and edits 3D scenes in Blender from a description; the server installs with uvx

MCP serverExtended access301

Blender MCP

MCP for Blender

Editors’ pick

An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender

MCP serverBroad access34.1K

README in short

The author brought a familiar agentic coding loop into SketchUp: state an intent, iterate quickly and keep history in git. The manual interface stays for sketches while the agent takes repetitive and parametric work.

README badge

Report a problem