← Back to directory

Sketchup MCP

Community

Connect Sketchup to Claude AI via MCP for prompt-driven 3D modeling and scene manipulation.

GitHub source repository ↗

★ 388 Stars Category · Dev Tools Popular Source revision aa096f04d3d7

35FMRS · D

Reliability

5/20

Security and permissions

3/20

Maintenance

6/20

Documentation

10/20

Setup experience

11/20

This MCP server provides powerful AI integration for Sketchup, but requires technical background and awareness of security risks.

Read the FMRS scoring method →

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. The system consists of two components: a Sketchup extension that creates a TCP server within Sketchup, and a Python MCP server that connects to it. It offers two-way communication, component manipulation, material control, scene inspection, selection handling, and Ruby code evaluation.

Tools

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.

Setup

Install uv via brew install uv. 2. Download or build the latest .rbz file, install the extension in Sketchup via Window > Extension Manager, and restart Sketchup. 3. Run the MCP server using uvx sketchup-mcp and configure Claude to use it.

claude_desktop_config.json

{
  "mcpServers": {
    "sketchup": {
      "command": "uvx",
      "args": [
        "sketchup-mcp"
      ]
    }
  }
}

Generate and validate client config

Fit and risk

Best for

Users of Sketchup who want AI-assisted modeling.
Designers and developers needing automation of modeling tasks.
Users familiar with Ruby and willing to extend Sketchup functionality.

Not for

Users who do not use Sketchup.
Lightweight scenes requiring real-time rendering or complex animations.
Environments with high security requirements that disallow arbitrary code execution.

Required permissions

Create, modify, delete components within Sketchup.
Execute arbitrary Ruby code, potentially affecting the Sketchup environment.
Network communication via TCP (default port 9876).

Risks and side effects

The eval_ruby tool allows arbitrary Ruby execution, which could crash Sketchup or corrupt data.
TCP connection is unencrypted and could be intercepted.
Dependencies on both Sketchup and MCP server running simultaneously; otherwise connection fails.

Troubleshooting

Ensure both the Sketchup extension server and the MCP server are running.
Check the Ruby Console in Sketchup for error messages.
For timeout errors, simplify requests or break them into smaller steps.

Use cases

Create 3D models via natural language commands, e.g., a house model.

Query and modify components in the current scene.

Apply materials or change component properties.

Export scenes to various formats.

Supported clients

Claude DesktopFull support

Related MCP servers

Compare with other MCP servers