Enables two-way communication with SketchUp, allowing component creation, manipulation, and transformation; material application; scene inspection; selection handling; and execution of Ruby code for 3D modeling and scene management.
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 simple house model with a roof and windows"
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 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.
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: RhinoMCP
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
We're using uv so you'll need to brew install uv
Download or build the latest .rbz file
In Sketchup, go to Window > Extension Manager
Click "Install Extension" and select the downloaded .rbz file
Restart Sketchup
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
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:
get_scene_info - Gets information about the current Sketchup scene
get_selected_components - Gets information about currently selected components
create_component - Create a new component with specified parameters
delete_component - Remove a component from the scene
transform_component - Move, rotate, or scale a component
set_material - Apply materials to components
export_scene - Export the current scene to various formats
eval_ruby - Execute arbitrary Ruby code in SketchUp for advanced operations
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"
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
The system uses a simple JSON-based protocol over TCP sockets:
Commands are sent as JSON objects with a type and optional params
Responses are JSON objects with a status and result or message
Contributions are welcome! Please feel free to submit a Pull Request.
MIT
Create a new component in Sketchup
Inputs: dimensions, position, type. Returns: result
Create a dovetail joint between two components
Inputs: pin_id (required), tail_id (required), angle, depth, +6 more. Returns: result
Create a finger joint (box joint) between two components
Inputs: board1_id (required), board2_id (required), depth, height, +5 more. Returns: result
Create a mortise and tenon joint between two components
Inputs: mortise_id (required), tenon_id (required), depth, height, +4 more. Returns: result
Delete a component by ID
Inputs: id (required). Returns: result
Evaluate arbitrary Ruby code in Sketchup
Inputs: code (required). Returns: result
Export the current scene
Inputs: format. Returns: result
Get currently selected components
Inputs: no named parameters. Returns: result
Set material for a component
Inputs: id (required), material (required). Returns: result
Transform a component's position, rotation, or scale
Inputs: id (required), position, rotation, scale. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 10 tools
Most tools have distinct purposes, such as creating specific joint types or managing components. However, create_component and transform_component could be slightly ambiguous if an agent needs to modify a component's geometry versus its transformation, but descriptions clarify their roles.
All tool names follow a consistent verb_noun pattern, using snake_case throughout. Examples include create_component, delete_component, and export_scene, making them predictable and easy to parse.
With 10 tools, this server is well-scoped for Sketchup automation, covering joint creation, component management, scene export, and Ruby evaluation. Each tool serves a clear purpose without redundancy.
The toolset provides good coverage for basic Sketchup operations, including CRUD for components and specific joint types. Minor gaps exist, such as no tool for listing all components or updating joint properties, but core workflows are supported.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
