SketchUp MCP server

SketchUp MCP

English | Tiếng Việt

SketchUp MCP lets Claude work directly in the SketchUp model you have open. Ask in plain language, in any language, and Claude reads the model, runs quantity takeoffs by tag or material, models geometry, assigns materials and tags, takes screenshots to check its own work, and exports images and files. It ships as a Claude Desktop extension (.mcpb) that runs on the Node.js built into Claude Desktop, plus a small Ruby extension for SketchUp (the SU MCP Bridge). You do not need to install Python or Node.js.

Current version: 1.2.0 - download it from Releases. Also listed in the official MCP Registry as io.github.2ez4gcx/sketchup-mcp.

Features

26 tools, all working in millimetres (areas in m², volumes in m³, angles in degrees, Z up):

Highlights:

• Quantity takeoff by tag or material: walks the whole model (or only the selection) and totals face area, face count, edge length, solid volume and component instance counts. Untagged or unpainted entities inherit the tag or material of their parent group.
• Screenshot that restores your view: Claude sees the viewport image directly. When it asks for a specific view (iso, top, front...), the camera changes only for the capture, and your own view comes back afterwards.
• runruby as one undo step**: when no dedicated tool fits, Claude can run Ruby API code. The whole snippet is a single Undo step. On an error the partial changes are rolled back, and the message points to the line in the snippet.
• Every model edit is one Undo step, named MCP: ... in SketchUp's Edit menu, so Ctrl+Z always takes back exactly one Claude action.
• installsketchupbridge: Claude installs or updates the Ruby bridge itself. It copies the files into the Plugins folder of every SketchUp version that has been opened at least once (dry_run only reports what it would do).
• Safe defaults: an existing material keeps its color unless Claude passes updateexisting=true. deleteentities only deletes by explicit id, never by selection. After a timeout, the error tells Claude whether the command may already have run, so it does not repeat the edit and create duplicate geometry.
• Version check: ping shows which model Claude is controlling and warns when the bridge in SketchUp is older than the one bundled in the extension.
• SketchUp menu (Extensions > SU MCP Bridge): Start server, Stop server, Status, Open log file, Change port....

Demo

This demo pavilion was built entirely through the MCP tools (createbox, createshape, runruby, setmaterial, settag), then checked with screenshot and quantitytakeoff - 82 tool calls in total.

How it works

Shortened. The full README is on GitHub.