SketchUp MCP server

This MCP server integrates Sketchup with Claude AI through the Model Context Protocol, enabling AI-assisted 3D modeling and manipulation. The integration provides two-way communication between Claude and Sketchup, allowing for prompt-driven control over components, materials, scene inspection, and more.

Installation Requirements

Python Package

First, install the required UV package manager:

brew install uv

Sketchup Extension

1. Download or build the latest .rbz file
2. In Sketchup, navigate to Window > Extension Manager
3. Click "Install Extension" and select the downloaded .rbz file
4. Restart Sketchup

Setting Up the Connection

Starting the Sketchup Server

1. Open Sketchup
2. Navigate to Extensions > SketchupMCP > Start Server
3. The server will start on port 9876 (default)

Configuring Claude

Add the MCP server configuration to your Claude settings:

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

This will use the latest version from PyPI.

Available Capabilities

The MCP server provides several tools for controlling Sketchup:

Scene Management

• get_scene_info: Retrieve detailed information about the current Sketchup scene
• get_selected_components: Get data about components currently selected in the scene
• export_scene: Export the current scene to various formats

Component Manipulation

• create_component: Create a new component with specified parameters
• delete_component: Remove components from the scene
• transform_component: Move, rotate, or scale components
• set_material: Apply materials and colors to components

Advanced Operations

• eval_ruby: Execute custom Ruby code directly in SketchUp for complex operations

Example Usage

You can ask Claude to perform various operations in Sketchup such as:

• "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

If you encounter issues:

• Connection problems: Verify both the Sketchup extension server and MCP server are running
• Failed commands: Check the Ruby Console in Sketchup for error messages
• Timeout errors: Try breaking complex requests into smaller steps

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.