SketchupMCP
Enables direct interaction and control of SketchUp models, allowing for component creation and manipulation, material management, scene inspection, and the execution of Ruby code for advanced 3D modeling tasks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SketchupMCP create a modern minimalist desk with a glass top and wooden legs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SketchupMCP - Sketchup Model Context Protocol Integration
SketchupMCP connects Sketchup to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Sketchup. This integration enables prompt-assisted 3D modeling, scene creation, and manipulation in Sketchup.
Big Shoutout to Blender MCP for the inspiration and structure.
Features
Two-way communication: Connect Claude AI to Sketchup through a TCP socket connection
Component manipulation: Create, modify, delete, and transform components in Sketchup
Material control: Apply and modify materials and colors
Scene inspection: Get detailed information about the current Sketchup scene
Selection handling: Get and manipulate selected components
Ruby code evaluation: Execute arbitrary Ruby code directly in SketchUp for advanced operations
Related MCP server: SketchupMCP
Components
The system consists of two main components:
Sketchup Extension: A Sketchup extension that creates a TCP server within Sketchup to receive and execute commands
MCP Server (
sketchup_mcp/server.py): A Python server that implements the Model Context Protocol and connects to the Sketchup extension
Installation
Python Packaging
We're using uv so you'll need to brew install uv
Sketchup Extension
Download or build the latest
.rbzfileIn Sketchup, go to Window > Extension Manager
Click "Install Extension" and select the downloaded
.rbzfileRestart Sketchup
Usage
Starting the Connection
In Sketchup, go to Extensions > SketchupMCP > Start Server
The server will start on the default port (9876)
Make sure the MCP server is running in your terminal
Using with Claude
Configure Claude to use the MCP server by adding the following to your Claude configuration:
"mcpServers": {
"sketchup": {
"command": "uvx",
"args": [
"sketchup-mcp"
]
}
}This will pull the latest from PyPI
Once connected, Claude can interact with Sketchup using the following capabilities:
Tools
get_scene_info- Gets information about the current Sketchup sceneget_selected_components- Gets information about currently selected componentscreate_component- Create a new component with specified parametersdelete_component- Remove a component from the scenetransform_component- Move, rotate, or scale a componentset_material- Apply materials to componentsexport_scene- Export the current scene to various formatseval_ruby- Execute arbitrary Ruby code in SketchUp for advanced operations
Example Commands
Here are some examples of what you can ask Claude to do:
"Create a simple house model with a roof and windows"
"Select all components and get their information"
"Make the selected component red"
"Move the selected component 10 units up"
"Export the current scene as a 3D model"
"Create a complex arts and crafts cabinet using Ruby code"
Troubleshooting
Connection issues: Make sure both the Sketchup extension server and the MCP server are running
Command failures: Check the Ruby Console in Sketchup for error messages
Timeout errors: Try simplifying your requests or breaking them into smaller steps
Technical Details
Communication Protocol
The system uses a simple JSON-based protocol over TCP sockets:
Commands are sent as JSON objects with a
typeand optionalparamsResponses are JSON objects with a
statusandresultormessage
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT
Available Tools
10 toolscreate_componentC
Create a new component in Sketchup
Inputs: type, position, dimensions. Returns: result
create_dovetailC
Create a dovetail joint between two components
Inputs: tail_id (required), pin_id (required), width, height, +6 more. Returns: result
create_finger_jointB
Create a finger joint (box joint) between two components
Inputs: board1_id (required), board2_id (required), width, height, +5 more. Returns: result
create_mortise_tenonC
Create a mortise and tenon joint between two components
Inputs: mortise_id (required), tenon_id (required), width, height, +4 more. Returns: result
delete_componentB
Delete a component by ID
Inputs: id (required). Returns: result
eval_rubyB
Evaluate arbitrary Ruby code in Sketchup
Inputs: code (required). Returns: result
export_sceneC
Export the current scene
Inputs: format. Returns: result
get_selectionB
Get currently selected components
Inputs: no named parameters. Returns: result
set_materialC
Set material for a component
Inputs: id (required), material (required). Returns: result
transform_componentC
Transform a component's position, rotation, or scale
Inputs: id (required), position, rotation, scale. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools have distinct purposes, but the joint creation tools (dovetail, finger_joint, mortise_tenon) could be confused as they all create joints between components with similar descriptions. However, their specific joint types are clearly named, reducing ambiguity.
All tools follow a consistent verb_noun pattern with snake_case, such as create_component, delete_component, and export_scene. This predictability makes the tool set easy to navigate and understand.
With 10 tools, the server is well-scoped for Sketchup operations, covering component management, joint creation, scene export, and scripting. Each tool serves a clear purpose without redundancy or excessive complexity.
The tool set covers key operations like creating, deleting, transforming, and selecting components, with additional features for joints and materials. Minor gaps include no explicit update_component tool, but transform_component and set_material can handle updates, and scene import is missing, though export_scene is present.
Maintenance
Related MCP Connectors
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
Related MCP Servers
- AlicenseBqualityDmaintenanceConnects Sketchup to Claude AI through the Model Context Protocol, allowing Claude to directly interact with and control Sketchup for prompt-assisted 3D modeling and scene manipulation.10545MIT
- AlicenseBqualityDmaintenanceIntegration that connects Sketchup to Claude AI through the Model Context Protocol, allowing Claude to directly interact with and control Sketchup for prompt-assisted 3D modeling, scene creation, and manipulation.1028MIT
- AlicenseAqualityBmaintenanceConnects SketchUp to Claude AI through the Model Context Protocol, enabling prompt-assisted 3D modeling, scene manipulation, and woodworking joinery operations.221,434 PyPI61MIT
- AlicenseAqualityDmaintenanceControls SketchUp via AI assistants, enabling 3D model creation programmatically through the Model Context Protocol.2115MIT