Skip to main content
Glama

Trimble SketchUp MCP Bridge 📐

License: MIT Ruby API Ecosystem

A Model Context Protocol (MCP) server that connects AI assistants (Google Antigravity, Claude Desktop, Cursor) directly with Trimble SketchUp for rapid architectural 3D conceptual massing, spatial planning, and solar shadow analysis.

Built for architecture students (B.Arch), urban designers, and conceptual modelers, enabling AI agents to programmatically query models, extrude massing floor plates, calculate shadow angles, and capture viewport renderings.


⚡ Key Highlights

  • Native Embedded Ruby Extension: Runs directly inside SketchUp's embedded Ruby runtime with zero external dependencies.

  • Live Fleet Registration: Automatically registers its dynamic port and PID with %LOCALAPPDATA%\AutodeskMCP\registry.json, enabling single-entry routing through autodesk-mcp.

  • Architectural Massing Tool Suite:

    • Model Inspection: Entities count, layers/tags, component definitions, and shadow settings.

    • 3D Massing Extrusion: Generate building footprints from coordinate polygons and push/pull into massing volumes.

    • Solar & Shadow Studies: Set date, solar time of day, and toggle shadows for daylight analysis.

    • Viewport Capture: Export shaded viewport images as base64 JPEG.


Related MCP server: SketchUp MCP Server

🚀 Quick Start

1. Installation

Run the automated installer:

.\install.ps1

This deploys sketchup_mcp.rb and sketchup_mcp/ to: %APPDATA%\SketchUp\SketchUp <Year>\SketchUp\Plugins\

2. Auto-Startup

The bridge server starts automatically in a background Ruby thread whenever Trimble SketchUp is opened.

3. Routing via Master Gateway

When running, the autodesk-mcp Gateway auto-detects SketchUp and routes sketchup_* tools seamlessly.


🛠️ Tool Suite

Tool

Description

sketchup_get_model_info

Retrieves active model entities, layers, and shadow settings.

sketchup_create_massing

Extrudes architectural massing volume from polygon footprint.

sketchup_set_shadows

Configures shadow display and solar hour for sun path analysis.

sketchup_capture_viewport

Captures shaded viewport image as base64.


📄 License

MIT License &copy; 2026 Aaradhya Dev Tamrakar

Related MCP Connectors

Related MCP Servers