ADAI SketchUp MCP
MCP server and skill for SketchUp: an agent builds an editable 3D model from photos, CAD or text and checks it against the source.
- 109 ★ on the repository
- Last commit
Extended access
Why this level
- The server writes and saves SKP files and runs Ruby inside SketchUp.
- Initial binding targets the SketchUp.exe path that you provide.
Install
- Works in
Manual install
Download the skill and MCP archives from the README install section, unpack them, set the `node` launch with the path to `launch.cjs`, install `su_mcp.rbz` in SketchUp and call `sketchup_runtime` with the `startup` action.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server writes and saves SKP files and runs Ruby inside SketchUp.
- Initial binding targets the SketchUp.exe path that you provide.
This is third-party code. Review the repository files before installing.
What it does
The kit is the `professional-sketchup-modeling` skill plus an MCP server. The skill tells the agent how to build a model and how to correct mistakes against an image. The server performs managed writes into SketchUp through Ruby transactions, reads geometry back and can recover an operation after a failure. The default guided mode runs six stages: complete form, representative element, copies, variants, surface detail and finish. Expert mode works in continuous work units. The source can be an image, a CAD drawing, text or an existing model, and the result is saved as an SKP file. A reference pack for ancient Chinese architecture ships with it.
Who it is for. Architects and visualizers on Windows who hand an agent in Codex a draft 3D building model built from photos or a drawing.
Good fit when
- A set of facade photos must become a building model that is then edited by hand.
- One window changes in a finished model without touching the other elements.
- Model dimensions must be compared with source dimensions to see the differences.
- A model of a Chinese building with typical roof elements is needed.
Not a fit when
- Work happens on macOS or Linux; the kit targets Windows.
- Automatic drawing recognition or structural calculation is needed; the author promises neither.
- The client is neither Codex nor PipClaw; other clients have to be verified by you.
Example request
Create an editable SketchUp model from these four facade photos in guided mode and after each stage show the view and a comparison with the photo.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
The author tested the kit on Windows with Codex and PipClaw, targeting SketchUp 2018 and 2019, with some checks on the real program and some on a stub. Adaptation for Claude is not claimed. Node.js 18 or newer and Python 3.10 or newer are required. Source dimensions are compared only for individual objects along axes, with no full constraint solver. Judge the result by the picture: object counts and operation success do not prove likeness. The CPAL-1.0 license requires attribution and the documentation is in Chinese.
How to disable. Remove the skill folder and the MCP directory from the agent settings, then the `su_mcp.rbz` extension in the SketchUp extension manager.
FAQ
How do I install the kit?
Download the two build archives (skill and MCP) from the README, copy the skill into the Codex or PipClaw skills directory, point the MCP launch to `node` with the path to `launch.cjs` and install `su_mcp.rbz` through the SketchUp extension manager.
What modes exist?
The guided mode is the default and runs six stages with an image check. Expert mode is enabled by the first line of the task and runs in continuous blocks without loosening checks or permissions.
Which units are used?
Typed operations such as `wall` and `window_frame` take millimeters. Direct Ruby API calls use native SketchUp inches that must be converted.
What if a write breaks halfway?
Call `sketchup_project_operation_receipt` and `sketchup_project_recover`: they first establish what was written and only then recover. Committed geometry is not replayed.
Does it work with Claude Code?
The author makes no such claim: it is adapted for Codex and PipClaw and other MCP clients need separate verification.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server and extension for SketchUp: an agent runs Ruby scripts in a model, inspects the scene and exports the result.
An MCP server for Autodesk 3ds Max: the agent reads the scene, models, and sets up materials and modifiers
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
Blender MCP
MCP for Blender
An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender
Blender Agent Studio builds models and scenes in Blender from a description: a .blend file, Python source and checked renders.
A local MCP server and CLI: the agent writes JavaScript for a 3D model, checks it on renders and exports a GLB with source
README in short
The kit ships as archives with SHA256 checksums. The MCP works over stdio, and the bridge to SketchUp is a local Ruby plugin using file exchange. Architectural knowledge comes in separate packs whose versions are independent of the product version.