# SketchUp MCP

> SketchUp MCP is an open-source MCP server for design and media. Let Claude model, tag and measure interiors in an open SketchUp model. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted
- **Repository:** https://github.com/2ez4gcx/sketchup-mcp
- **MCP Registry name:** io.github.2ez4gcx/sketchup-mcp
- **Categories:** design and media, construction estimating
- **Listing updated:** 2026-11-15

## About

Interior design and fit-out work is where this server is most specific. Claude can tag what it models like a finish schedule, using codes such as FL for floors, WL for wall finishes and CL for ceilings, so one tag equals one line of a bill of quantities. The interior_takeoff tool then produces a row per tag in the right unit (square metres, metres, counts), with totals, warnings about untagged or hidden geometry, and an optional CSV for Excel. A by_room option splits every line by named room group.

A create_room tool builds a whole room from an outline, height and finishes: floor, wall panels with door and window cut-outs, ceiling, skirting and door leaves, each tagged inside a room group. Further tools check the model for duplicates, inside-out solids and unused items, create documentation scenes such as reflected ceiling plans and elevations, and run design checks like ceiling clearance and furniture in door swings. The README says those limits are reference values, not a building-code check.

It installs as a Claude Desktop extension plus a small Ruby bridge inside SketchUp, talking over a localhost TCP port. Each edit is one Undo step. SketchUp 2017 or later is required, and the README says it was tested on 2021 and 2023.

## Features

- **Interior takeoff:** Bill of quantities per tag with units suited to each category, exportable to CSV.
- **Professional tagging:** Finish-schedule style tags with category folders and colors.
- **One-step room creation:** Builds floor, walls, ceiling, skirting, doors and glass from an outline.
- **Model and design checks:** Flags duplicates, loose geometry, tight passages and clearance problems.
- **Documentation scenes:** Creates plans, reflected ceiling plans and elevations per room.
- **Ruby scripting:** run_ruby executes API code as a single undoable step, rolling back on error.
- **Screenshots and export:** Claude can view the viewport and export images and files.

## Good for

- Produce a room-by-room bill of quantities from a SketchUp interior
- Set up a consistent tag scheme for a fit-out model
- Generate a room with finishes from a floor outline
- Check a model for duplicate geometry before measuring
- Generate plan and elevation scenes for documentation

## Install

### Claude Code (Terminal)

```sh
claude mcp add sketchup-mcp -- npx -y https://github.com/2ez4gcx/sketchup-mcp/releases/download/v1.5.0/sketchup-mcp-1.5.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/2ez4gcx/sketchup-mcp/releases/download/v1.5.0/sketchup-mcp-1.5.0.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/2ez4gcx/sketchup-mcp/releases/download/v1.5.0/sketchup-mcp-1.5.0.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sketchup-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/2ez4gcx/sketchup-mcp/releases/download/v1.5.0/sketchup-mcp-1.5.0.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/2ez4gcx/sketchup-mcp/releases/download/v1.5.0/sketchup-mcp-1.5.0.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/2ez4gcx/sketchup-mcp/releases/download/v1.5.0/sketchup-mcp-1.5.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `quantity_takeoff`: Totals face area, edge length, volume and instance counts by tag or material.
- `interior_takeoff`: Builds a bill of quantities per tag, optionally by room and saved as CSV.
- `create_room`: Builds a room with finishes from an outline and height.
- `check_model`: Checks the model for geometry and housekeeping problems.
- `check_design`: Runs design checks such as ceiling height and door swing clearance.
- `create_scenes`: Creates documentation scenes such as plans and elevations.
- `setup_tags`: Creates the standard tag scheme.
- `run_ruby`: Runs SketchUp Ruby API code as one undo step.
- `screenshot`: Captures the viewport image.
- `install_sketchup_bridge`: Installs or updates the Ruby bridge in SketchUp.
- `purge_unused`: Removes unused components, materials and tags.

## FAQ

### What do I need installed?

Claude Desktop, SketchUp 2017 or later, and the SU MCP Bridge Ruby extension, which the install_sketchup_bridge tool can set up. No separate Python or Node.js install is needed.

### Which units does it use?

Millimetres, with areas in square metres, volumes in cubic metres and angles in degrees.

### Can I undo what Claude does?

Yes. Every model edit is a single Undo step named MCP in SketchUp's Edit menu.

### Is it a building-code checker?

No. The design-check limits are common reference values to adjust to your project's rules.

### How does it connect to SketchUp?

Over TCP on localhost, default port 9876, configurable with SKETCHUP_MCP_PORT.

### Is SketchUp MCP free?

Yes. SketchUp MCP is open source, so you can use and self-host it for free.

### How do I add SketchUp MCP to Claude Code?

Run this command in your terminal: claude mcp add sketchup-mcp -- npx -y https://github.com/2ez4gcx/sketchup-mcp/releases/download/v1.5.0/sketchup-mcp-1.5.0.mcpb

### What are the best alternatives to SketchUp MCP?

The closest alternatives to SketchUp MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/sketchup-mcp
