get_model_infoLABSCO SUMMARY
SketchUp has to be open, because half of this runs inside it.
The Ruby plugin is the part that touches the model, and the Python server only talks to it over localhost, so nothing works until SketchUp is running with the plugin loaded. What you get in return is real modelling rather than export tricks — and construction knowledge shipped alongside, so create_roof_truss builds a king post or fink truss rather than a shape that looks like one.
What it is
A two-part SketchUp integration: a Ruby plugin that runs inside SketchUp and exposes an HTTP API, and a Python MCP server that turns tool calls into requests against it.
What you get
- 21 tools covering inspection, creation, transformation and components
- Model inspection: get_model_info, list_layers, list_materials, list_entities, list_components
- Geometry: create_face, create_edge, create_group, create_box, create_circle, create_arc, create_polygon
- Extrusion: push_pull for a face, follow_me along a path of edges
- Transforms: move_entity, rotate_entity, scale_entity
- Components: create_component and place_component
- create_roof_truss for king post or fink trusses, plus construction reference resources on trusses, framing and stairs
- execute_ruby for anything the tools do not cover
Requirements
SketchUp 2024, 2025 or 2026 with sketchup_mcp_server.rb copied into its Plugins folder, and Python 3.10 or newer for the server (uv sync or pip install -e . in the cloned repository). SketchUp must be open — the plugin listens on port 8080.
Setup effort
Build from source — git clone https://github.com/Tarkiin/sketchup-mcp.git
USE CASES
01
Blocking out a room from a description
Create the footprint, then extrude it to height.
02
Getting oriented in someone else's model
Read the model info, then list the entities and layers before you change anything.
03
Framing a roof
Generate king post or fink trusses instead of drawing each member.
04
Doing something the tools do not cover
Run Ruby directly against SketchUp's own API from the same session.
21 tools
Listed in project docs. Your client may show a different list.
list_layerslist_materialslist_entitieslist_componentscreate_facecreate_edgecreate_groupcreate_boxcreate_circlecreate_arccreate_polygonpush_pullfollow_memove_entityrotate_entityscale_entitycreate_componentplace_componentcreate_roof_trussexecute_rubyBEFORE YOU INSTALL
What to know first
Tools you get
21 tools named in the project's documentation.
Requires
- uv on PATH
- Python 3.10+
Where it runs
All 4 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/Tarkiin/sketchup-mcp.git
cd sketchup-mcp
uv syncCopy the SketchUp plugin into SketchUp's Plugins folder — macOS: cp sketchup_plugin/sketchup_mcp_server.rb ~/Library/Application\ Support/SketchUp\ 2026/SketchUp/Plugins/ — Windows (PowerShell): Copy-Item "sketchup_plugin\sketchup_mcp_server.rb" "$env:APPDATA\SketchUp\SketchUp 2026\SketchUp\Plugins\" -Force (the 2026 in it is the SketchUp version)
Open SketchUp — the plugin starts its HTTP server on port 8080 (if not, Plugins → MCP Server → Start Server) — then add the configuration to your client with the absolute path of your clone
MCP Clients
Antigravity, AI Studio, Claude Desktop, Cursor
JSON
{
"mcpServers": {
"sketchup": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_SKETCHUP_MCP>",
"run",
"sketchup-mcp"
]
}
}
}<YOUR_PATH_TO_SKETCHUP_MCP> is the absolute path of your clone.
