SketchUp MCP
Let Claude model, tag and measure interiors in an open SketchUp model
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media