SketchUp MCP server

This integration allows Claude AI to interact directly with SketchUp through the Model Context Protocol (MCP), enabling prompt-assisted 3D modeling, scene creation, and SketchUp manipulation. It offers a seamless connection between Claude and SketchUp for enhanced modeling capabilities.

Installation

Setting Up the SketchUp Extension

1. Download 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

Installing Python Requirements

First, install uv for Python environment management:

pip install uv

Installing via Smithery

To install SketchUp MCP using Smithery:

npx -y @smithery/cli install @BearNetwork-BRNKC/SketchUp-MCP --client claude

Usage Guide

Establishing Connection

1. In SketchUp, go to Extensions > SketchupMCP > Start Server
2. The server will start on port 9876 by default
3. Ensure the MCP server is running in your terminal

Using with Claude

Add the following to your Claude configuration to use the MCP server:

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

This will automatically download the latest version from PyPI.

Available Tools

Once connected, Claude can interact with SketchUp through these functions:

• get_scene_info - Retrieves information about the current SketchUp scene
• get_selected_components - Gets information about currently selected components
• create_component - Creates new components with specified parameters
• delete_component - Removes components from the scene
• transform_component - Moves, rotates, or scales components
• set_material - Applies materials to components
• export_scene - Exports the current scene in various formats
• eval_ruby - Executes arbitrary Ruby code in SketchUp for advanced operations

Example Commands

Here are some operations you can ask Claude to perform:

• "Create a simple house model with a roof and windows"
• "Select all components and get their information"
• "Turn the selected components red"
• "Move the selected components up by 10 units"
• "Export the current scene as a 3D model"
• "Create a complex arts and crafts cabinet using Ruby code"

Troubleshooting

• Connection issues: Ensure both the SketchUp extension server and MCP server are running
• Command execution failures: Check the SketchUp Ruby console for error messages
• Timeout errors: Try simplifying requests or breaking operations 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.