SketchUp MCP (hardened fork)

Connect SketchUp to any MCP client (Claude Desktop, Claude Code, etc.) and drive it in natural language — create, transform and materialize geometry, run boolean operations, chamfer/fillet edges, build woodworking joints, and export the scene.

Provenance

• Maintained by NeoNexAI Agency (AI consulting studio). Contact: info@neonexai.com.
• Hardened fork of mhyrr/sketchup-mcp, itself inspired by blender-mcp.
• What "hardened" means: the upstream project exposed an eval_ruby tool (arbitrary Ruby execution inside SketchUp → full disk/network access). This fork removes it entirely — Python server and Ruby extension — and the extension socket listens only on 127.0.0.1. The tool surface is 13 explicit, bounded tools. Audit the code yourself before installing, as you would with any third-party software: the diff vs upstream is public.

Architecture (two pieces)

SketchUp has no external API: it can only be driven from its embedded Ruby API. Hence two components working together:

MCP client (Claude Desktop / Claude Code)
        │  (MCP, stdio)
        ▼
  MCP server (Python, this package — uvx)
        │  (TCP socket 127.0.0.1:9876)
        ▼
  SketchUp extension (Ruby, su_mcp/)  ──►  SketchUp

Requirements

• SketchUp 2021 or later (Windows; the Ruby extension uses only the standard SketchUp Ruby API).
• Python 3.10+ and uv/uvx (pip install uv or winget install astral-sh.uv).

Installation

Step 1 — SketchUp extension (Ruby)

Copy su_mcp.rb and the su_mcp/ folder from this repository into:

%AppData%\SketchUp\SketchUp 20XX\SketchUp\Plugins\

(replace 20XX with your version). Restart SketchUp, then start the server: menu Extensions → SketchUp MCP → Start Server (listens on 127.0.0.1:9876).

Alternative: zip su_mcp.rb + su_mcp/, rename to .rbz, and install via Window → Extension Manager → Install Extension.

Step 2 — MCP server (Python)

Pin the version you audited (recommended — avoids silently pulling future releases):

Claude Desktop — %AppData%\Claude\claude_desktop_config.json:

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

Claude Code — same block in %UserProfile%\.claude.json, or via CLI:

claude mcp add sketchup --scope user -- uvx neonexai-sketchup-mcp==1.1.0

From GitHub instead of PyPI (pin to a commit for reproducibility):

"args": ["--from", "git+https://github.com/NeoNexAI/sketchup-mcp@main", "neonexai-sketchup-mcp"]

Restart the client. First call to make: sketchup_status.

Tools (13)

Example prompts

• "Create a 200×80×40 box at the origin and apply 'Wood_Cherry'."
• "Select that piece" → sketchup_get_selection → "move it 50 up in Z."
• "Boolean difference: subtract the cylinder (tool) from the block (target)."
• "Fillet all edges of that board with radius 1.5."
• "Export the scene to DAE."

Units: SketchUp models default to inches. Tell your assistant which units you work in (cm/m) so it converts.

What it does NOT do

• No photorealistic rendering — render plugins (V-Ray, Enscape, etc.) expose no scripting surface here; keep launching them from their own UI.
• No arbitrary code execution — by design. The 13 tools above are the whole surface.
• No network access — the extension accepts local connections only.

Configuration (env vars)

Troubleshooting

• "No se pudo conectar con SketchUp" → the extension server is not running: Extensions → SketchUp MCP → Start Server.
• Command errors → open SketchUp's Ruby Console (Window → Ruby Console) for the detailed message.
• Boolean operation fails → both entities must be closed (manifold) solids, not open surfaces.

License

MIT.