Sketchup MCP Server

3D modeling and scene manipulation via TCP socket commands in SketchUp.

Data last scanned last week · Reviewed last month

Overview

Sketchup MCP Server establishes a bridge between Claude AI and SketchUp, utilizing a TCP socket connection to facilitate two-way communication. It enables AI-assisted generation and modification of 3D models, allowing users to perform operations like component creation, material application, and scene exporting through natural language prompts. The system architecture involves a specialized SketchUp extension acting as a server and a companion Python implementation of the Model Context Protocol. By leveraging tools for transformation, selection handling, and Ruby code evaluation, it provides an interface for both simple scene adjustments and complex programmatic model generation.

Our verdict

With a security score of 21/100, this tool is categorized as high risk and should be used with caution in professional environments. The lack of an established software license creates legal uncertainty regarding usage, and the project is maintained by a single contributor with no official vendor backing. Users should be aware that the 'eval_ruby' capability allows the execution of arbitrary code within the SketchUp environment, which requires careful oversight.

Zero direct dependencies minimizes supply-chain surface area.
Provides direct capabilities for component transformation and scene inspection.
Supports arbitrary Ruby code evaluation for advanced operations.

High risk score due to lack of an official vendor.
No license detected for legal compliance.
Single contributor represents a bus-factor risk.
Community-maintained project without editorial review.

Tools

Tool	Description	Risk
get_scene_info	Gets information about the current Sketchup scene	low
get_selected_components	Gets information about currently selected components	low
create_component	Create a new component with specified parameters	medium
delete_component	Remove a component from the scene	high
transform_component	Move, rotate, or scale a component	medium
set_material	Apply materials to components	medium
export_scene	Export the current scene to various formats	low
eval_ruby	Execute arbitrary Ruby code in SketchUp for advanced operations	high

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›What software components are required to use this MCP server?

You need to install the Sketchup extension via an .rbz file and run the Python MCP server. The Python server requires uv for installation.

›How do I start the connection between Sketchup and the MCP server?

First, start the server within Sketchup by navigating to Extensions > SketchupMCP > Start Server. Then, ensure your Python MCP server is running in your terminal.

›What is the default port used by the Sketchup extension?

The Sketchup extension starts the server on port 9876 by default.

›Can I perform advanced operations beyond the standard toolset?

Yes, you can use the eval_ruby tool to execute arbitrary Ruby code directly within Sketchup.

›How can I debug issues if commands are failing?

You should check the Ruby Console inside Sketchup for specific error messages related to command failures.

›What should I do if I encounter timeout errors?

If you experience timeouts, try breaking your requests into smaller steps or simplifying your prompts.