Skip to content
MCP server

SketchUp MCP

Let Claude model, tag and measure interiors in an open SketchUp model

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted
Runs
Locally
Version
1.5.0
Listing updated
2 days ago

About SketchUp MCP

SketchUp MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • SKETCHUP_MCP_PORTTCP port of the SU MCP Bridge extension in SketchUp (must match the port set in SketchUp)
  • SKETCHUP_MCP_TIMEOUTSeconds to wait for SketchUp to answer one command

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

SketchUp MCP 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 to SketchUp MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media