home / mcp / sketchup mcp server

SketchUp MCP Server

SketchUp-MCP For AI

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bearnetwork-brnkc-sketchup-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@BearNetwork-BRNKC/SketchUp-MCP",
        "--client",
        "claude"
      ]
    }
  }
}

SketchupMCP connects SketchUp to Claude AI using the Model Context Protocol (MCP), enabling Claude to directly interact with and control SketchUp for guided 3D modeling, scene creation, and component management.

How to use

You run the MCP client to bridge Claude with SketchUp, then use Claude to issue high-level modeling commands. Through this integration you can query current scene details, inspect and modify selected components, create or transform components, apply materials, and even execute Ruby code inside SketchUp for advanced operations. Claude can orchestrate tasks such as building simple houses, modifying selections, changing colors, exporting scenes, and performing scripted actions through the MCP interface.

How to install

Prerequisites you need to prepare before running SketchupMCP include Node.js, Python, and a Python environment manager. You also need the SketchUp extension file (rbz) to enable the internal TCP server inside SketchUp.

Install the SketchUp extension in SketchUp:

• Download or build the latest .rbz file for the SketchUp extension.

• In SketchUp, open Window > Extension Manager.

• Click Install Extension and select the downloaded .rbz file.

• Restart SketchUp after installation.

Install the Python environment manager uv and the MCP client:

pip install uv

Install Sketchup MCP via Smithery (optional but recommended):

npx -y @BearNetwork-BRNKC/SketchUp-MCP --client claude

Additional installation notes

Start the SketchUp MCP server from within SketchUp to enable communication with Claude. You will run the server process that listens on the default port and forwards commands to the SketchUp extension for execution.

Available tools

get_scene_info

Retrieve detailed information about the current SketchUp scene, including components, materials, and scene properties.

get_selected_components

Return information about the currently selected components in the active SketchUp scene.

create_component

Create a new component in the SketchUp scene with specified parameters such as geometry, position, and materials.

delete_component

Remove a specified component from the SketchUp scene.

transform_component

Move, rotate, or scale a component within the scene using given transformation parameters.

set_material

Apply or modify a material on a component, including color and texture settings.

export_scene

Export the current scene to common 3D formats for sharing or further processing.

eval_ruby

Execute arbitrary Ruby code inside SketchUp for advanced operations and automation.