SketchUp MCP

Create a rectangular box (group). width along X, depth along Y, height along Z, in mm. origin [x,y,z] mm is the lower-left corner. Missing tags/materials are created; color is '#RRGGBB' or a color name (only applied when the material is newly created; an existing material keeps its color). Returns: {id, persistent_id, type, name, tag, material, bounds_mm{min,max,size}}.

Draw a polyline through [x,y,z] mm points in a new group. close_face=true: closes back to the first point and creates a face (the result has face_created).

Draw a flat face from a polygon (list of [x,y,z] mm points, >= 3 coplanar points) in a new group. pushpull (mm) extrudes it into a solid (e.g. draw a floor outline, then pull it up to the slab thickness). Returns: {id, persistent_id, type, name, tag, material, bounds_mm{min,max,size}}.

Delete entities by id (ids are required; never deletes by selection). Can be undone.

Export the model to a 3D/2D file chosen by extension (dae, obj, stl, fbx, dwg, dxf, 3ds...). Some formats require SketchUp Pro.

Export the viewport as a PNG/JPG file (e.g. 'D:/Export/perspective.png'). width/height in pixels; view changes the camera first.

Insert a component: from a .skp file (path, e.g. 'D:/Library/table.skp') or from a definition already in the model (definition = name). position [x,y,z] mm, rotation_deg rotates about the Z axis.

Install (or update) the "SU MCP Bridge" extension in SketchUp so the other tools can connect. Copies su_mcp.rb + su_mcp/main.rb into the Plugins folder of every SketchUp version found (Windows: %APPDATA%/SketchUp/SketchUp 20xx/SketchUp/Plugins). SketchUp must be restarted afterwards. Empty versions = every version opened at least once; dry_run=true only reports what would be done. Also returns the path of su_mcp.rbz for a manual install via Extension Manager.

Bill of quantities (BOQ) for interior work: one row per tag (= one specification), with the unit its category needs: FL floors and CL ceilings -> area m², once per board whatever its face orientation, sloped parts at their real area; WL wall finishes, PA partitions, GL glass -> area of ONE side of each thin upright piece (openings cut in one side deducted), m²; SK skirting, CO cornices -> length m (runs made with Follow Me too); CU curtains -> width x height m²; EX existing structure -> volume m³; DR, WN, JN, FN, LT, SN, EQ, DE -> count (outermost group/component per tag, by definition). Every row also has all the other measures, and the totals per category. by_room=true adds the quantity of every row per room (a room = a named group WITHOUT a tag, e.g. "Living room"; otherwise taken from object names "<code> <room> - <location>"). RF reference tags are skipped. Warnings list geometry that is in no tagged object and parts that could not be measured (e.g. a wall that is not a thin object). csv_path also writes the table to a CSV file for Excel (with by_room: one column per room).

List component definitions and their instance counts (sorted descending) - use it to count equipment/furniture. include_groups=true also lists groups.

List the materials in the model: name, RGB color, transparency, texture file.

List tags (layers): name, visible/hidden, color, folder (SketchUp 2021+) and number of entities using the tag (including inside definitions).

Put existing entities into a new group (they must be at the level being edited, e.g. the top level). Use it for rooms: a named group WITHOUT a tag (e.g. name "Living room") holding the finishes and items of that room, so interior_takeoff can split quantities by room. With tag, it makes an assembly (e.g. several skirting runs). Returns: {id, persistent_id, type, name, tag, material, bounds_mm{min,max,size}}.

Overview of the open model: path, units, bounding box size (mm), number of top-level groups/components/ faces/edges, and number of tags, materials, definitions, scenes and selected entities.

Create a new (empty) model.

Open a .skp file in SketchUp.

Check the connection to SketchUp: returns the SketchUp and Ruby versions, the open model name, and the versions of the bridge in SketchUp and of the MCP server (warns if the bridge is older than the bundled one).

Quantity takeoff: walks the whole model recursively (or only the selection) and totals by tag or material: face area (m2, one side), face count, total edge length (m), solid volume (m3) and instance count per component. Untagged/unpainted entities inherit from their parent group. Raw totals only (face area counts every face of a solid): for a bill of quantities use interior_takeoff.

Run arbitrary Ruby code in SketchUp (Ruby API). Use it when the other tools are not enough. Useful objects: Sketchup.active_model, model.entities, model.selection. Internal units are inches: use 1000.mm, x.to_mm. The whole snippet is one Undo step. Returns the last value (inspect) and the puts output. Rules: do NOT call start_operation/commit_operation (the bridge already wraps the code in one Undo step); find entities with Sketchup.active_model.find_entity_by_id(id); check face.normal before pushpull; vertex coordinates inside a group are local (multiply by the parent group transformation); end with a value or puts; never call exit.

Save the model. Empty path = overwrite the current file; with path = Save As.

Capture the SketchUp viewport and return the image so Claude can see it directly (to check modelling results). Empty view = keep the current view. With view, the camera changes only temporarily for the capture and the previous view is restored afterwards.

Select entities by id in SketchUp (so the user can see them, or for later tools to use).

Info on the selected entities: id, type, name, tag, material, bounding box (mm), face area (m2), solid volume (m3). The ids are used by the edit/delete tools.

Apply a material to entities (entity_ids or the current selection). A missing material is created with color; an EXISTING material keeps its color (unless update_existing=true).

Assign a tag to entities (entity_ids or the current selection). A missing tag is created (in its category folder with its category color when it follows the tag standard). Tag groups/components, not raw faces or edges.

Set a standard view and zoom extents. iso defaults to perspective, the other views to parallel projection.

Create tags in one Undo step, following the interior tag standard "<CODE>-<NN> <description>", codes: FL floor finishes, SK skirting, WL wall finishes, PA partitions, CL ceilings, CO cornices and trims, DR doors, WN windows, GL glass partitions, JN built-in joinery, FN loose furniture, LT lighting, SN sanitary ware, EQ equipment and appliances, CU curtains and blinds, DE decor and accessories, EX existing structure, RF reference (not measured). Each tag goes into its category folder (SketchUp 2021+, e.g. "FL Floor finishes") and gets its category color (Tags panel > Color by tag). Use it to create every tag of a finish schedule at once, before modelling. Existing tags keep their folder and color unless update_existing=true. Tags without a known code get no folder/color unless given.

Move / rotate / scale entities. Empty entity_ids = use the current selection. translate [dx,dy,dz] mm; rotate_deg about axis (default Z) at pivot (mm, default entity center); scale is a uniform factor. Order applied: scale -> rotate -> translate.

Undo the last step in SketchUp (every model-editing tool is one Undo step).