sketchup-headless-mcp
Enables headless automation of SketchUp 2026 by running Ruby scripts to generate parametric CAD/BIM/millwork/lighting geometry, 2D orthographic plans, and output manifests through a process-managed runner.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
sketchup-headless-mcp
Headless SketchUp 2026 Ruby automation runner, FastMCP server, and deterministic parametric Ruby CAD/BIM/millwork/lighting libraries (SketchUpMCPArch, SketchUpMCPCabinetry, SketchUpMCPFinishLighting).
Why?
Automating SketchUp via -RubyStartup typically fails in headless agent workflows due to:
Interactive welcome modals when launched without a seed
.skpfile.Lingering background SketchUp processes blocking subsequent runs.
Non-manifold solids, overlapping bounding boxes, or missing 2D orthographic CAD plan/RCP symbols.
sketchup-headless-mcp pairs a clean process-managed Python runner and MCP server with production-tested Ruby geometry builders designed for zero-overlap manifold solids and dual 3D + 2D architectural output.
Related MCP server: Ringo SketchUp MCP
Features
Headless Runner (
runner.py): Launches SketchUp with a clean blankassets/startup_seed.skp, injectsSKETCHUP_MCP_LIB_DIR, polls for the output JSON manifest, and tears down cleanly on completion or timeout.FastMCP Server (
server.py): Exposesget_environment_status,list_ruby_libraries,run_sketchup_ruby, andbuild_parametric_demo.Parametric Ruby Libraries (
lib/):SketchUpMCPArch(lib/sketchup_arch_lib.rb): Calibrated raster underlays, swing/sliding doors, cut-plane-safe windows, straight stairs with diagonal break symbols, 2D furniture CAD projections, and LayOut hybrid viewports.SketchUpMCPCabinetry(lib/sketchup_cabinetry_lib.rb): OpenCutList-aligned local-axis manifold panels, recessed plinths, multi-bay carcasses, 2 mm reveal swing/aluminum-glass doors, pelmets, wall scribes, curved end units, and full wardrobe/kitchen assemblies.SketchUpMCPFinishLighting(lib/sketchup_finish_lighting_lib.rb): Anti-glare L-box cove ceilings, aluminum LED profiles, curtain pelmets, downlight grids, anti-sliver floor tile setout planner, and recursive AABB overlap + manifold QA auditing.
Quickstart
pip install -e .Run the CLI Headless Runner
sketchup-headless-run \
--rb examples/demo_room.rb \
--manifest out/demo_manifest.json \
--probe-out out/demo_manifest.jsonConfigure as an MCP Server
{
"mcpServers": {
"sketchup-headless": {
"command": "sketchup-headless-mcp",
"env": {
"SKETCHUP_EXE": "C:\\Program Files\\SketchUp\\SketchUp 2026\\SketchUp\\SketchUp.exe"
}
}
}
}License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
Manage SysML2 projects; check, evaluate, verify, query, document and diagram models.
150+ hosted tools: describe-to-build CAD, scan-to-CAD, architecture studio, web research, media.
Text-to-CAD: build exact STEP or 3MF/STL on the server, each stated requirement measured.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables controlling SketchUp from MCP-compatible clients via a stdio Python server that bridges to a Ruby plugin, supporting component operations, material assignment, scene export, arbitrary Ruby evaluation, and wood joinery tools.1013MIT
- AlicenseCqualityBmaintenanceEnables MCP clients to inspect and modify SketchUp models through a local authenticated bridge, covering entity creation and editing, geometry, materials, tags, cameras, scenes, transactions, snapshots, and file or view export. It also offers an optional full SketchUp Ruby API execution channel and batch operations for furniture, architectural, and analysis tasks.371MIT
- AlicenseAqualityCmaintenanceEnables AI clients to drive SketchUp Pro 2026 on a Windows host, including from WSL, by executing arbitrary Ruby in the active model, reading scene and selection details, and capturing viewport screenshots. It talks to a loopback TCP bridge inside SketchUp using a connect-per-command protocol for reliable, desync-free control.4MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to automate 2D architectural drafting and CAD file management, including DXF/DWG parsing, SVG/PNG/PDF rendering, wall extrusion to 3D STL meshes, room and beam analysis, block/script library access, and persistent depot storage via a REST API and MCP tools.18MIT