Skip to main content
Glama

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:

  1. Sketchup Extension: A Sketchup extension that creates a TCP server within Sketchup to receive and execute commands

  2. 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

  1. Download or build the latest .rbz file

  2. In Sketchup, go to Window > Extension Manager

  3. Click "Install Extension" and select the downloaded .rbz file

  4. Restart Sketchup

Usage

Starting the Connection

  1. In Sketchup, go to Extensions > SketchupMCP > Start Server

  2. The server will start on the default port (9876)

  3. 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 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

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 type and optional params

  • Responses are JSON objects with a status and result or message

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Available Tools

10 tools
create_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

    B3.3/5.0

    Scored across 10 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Connects 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.
      10
      545
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Connects SketchUp to Claude AI through the Model Context Protocol, enabling prompt-assisted 3D modeling, scene manipulation, and woodworking joinery operations.
      22
      1,434 PyPI
      61
      MIT