
To connect Claude to SketchUp, open Claude, go to Customize, then Connectors, add Trimble SketchUp from the directory and sign in with a Trimble ID. Claude can then build a new SketchUp model from a sentence or a sketch and give you a .skp file to download. That official connector has a hard limit, though: it cannot open or edit a model you already have. For that you need a community MCP server, which plugs Claude into SketchUp desktop on your own computer and is powerful, rough around the edges and a real security decision.
Our articles are still written by humans!
Get human written articles in your Google feed.
I run MeltFlex, and we ship our own SketchUp extension, so I spend more time in SketchUp’s Ruby plumbing than most designers would want to. For this guide I opened the Claude listing and went through the connect flow up to Trimble’s sign-in on October 10, 2026, and I read the source code of the two community servers line by line. I did not run client work through the connector. Where I describe how good the models are, I am quoting people who did, and I link them.

The official listing in Claude’s directory, as we saw it on October 10, 2026. Note the tool names; Trimble’s own help page lists a different set, more on that below.
The short version
sketchup-mcp2 server with SketchUp Pro desktop.There are three, and they do very different jobs. Most guides only describe one of them, which is how people end up installing a GitHub project when the official connector would have done, or the other way round.
| Route | Where the model lives | Edits existing models | You need | Setup |
|---|---|---|---|---|
| Official Trimble connector | A cloud SketchUp session, then a .skp download | No | Claude account + Trimble ID | Two minutes |
| Community MCP server (sketchup-mcp, sketchup-mcp2) | Your open SketchUp desktop file | Yes | SketchUp Pro or Studio desktop, Claude Desktop or Claude Code, uv | 20 to 40 minutes |
| Claude writes Ruby, you paste it | Your open SketchUp desktop file | Yes, by hand | Any Claude plan, SketchUp desktop | None |
SketchUp is a sensible place for this to land first. Trimble reported more than one million active SketchUp subscribers in November 2024, and it is the default massing tool in a lot of small studios and interior practices. The appetite for AI is uneven, though. The AIA found in March 2025 that only 6% of US architects regularly used AI in their work, while 90% worried about inaccurate outputs, and RIBA’s 2025 AI report put UK practices using AI at 59%, up from 41% a year earlier. Both numbers matter here: the people this connector is for are curious and skeptical in about equal measure.


The two products being joined, captured from their own homepages on October 10, 2026. The euro sign in SketchUp’s header is because we browsed from Europe; prices in this guide are from the US pricing page.
Trimble and Anthropic launched the connector on April 28, 2026. Trimble calls it the first connector it has built on the Model Context Protocol, and says Claude “builds the geometry in a cloud SketchUp session, verifying dimensions iteratively.” In practice that means SketchUp does not need to be installed on your computer at all. The steps:

Step 3, as it appeared for us: clicking Connect hands you to Trimble’s sign-in. A Claude account alone is not enough.
A few things the listing does not tell you. The connector URL is https://api.sketchup.com/mcp/v1/sketchup/mcp, so it is a remote server run by Trimble, and your prompts and reference images go to Trimble as well as to Anthropic. Claude uses inches unless you ask for metric. And the tool names do not match: the directory lists build_model, get_docs and save_model, while Trimble’s help page, updated August 21, 2026, describes get_docs, evaluate_py (“executes Python code against the live model”) and save_model. My read is that Claude writes Python against SketchUp’s SDK in Trimble’s cloud, and one of the two pages is out of date. It does not change how you use it, but it is a small sign that this is still version 1.
This is the part most launch coverage skipped, and it decides whether the connector is useful to you at all. All of it comes from Trimble’s own help page.

Trimble’s help article. The grey note box is the single most important sentence for anyone with an existing project.
| Limit | What it means in practice |
|---|---|
| Creates new files only | You cannot upload a client’s .skp and ask Claude to add a dormer. It cannot edit or render an existing file. |
| No memory between chats | Models are not stored in Claude. Download every version, or it is gone. |
| Static preview | The thumbnail is a picture, not a 3D view. You have to open the file in SketchUp to check it. |
| Free cap | Without a paid SketchUp plan you can save up to 30 models. One Trimble interview called it 30 per month; the help page does not mention a reset. |
| Long threads drift | Trimble warns that generating across several chat threads “may lead to less stable output”. Iterate in one thread. |
| Geometry, not renderings | Trimble tells you to prompt for form and proportion, not photorealism. |
The first row is the deal breaker for a lot of studios. Most of the time in SketchUp is spent changing a model that already exists, and that is exactly the job the official connector does not do. Iterating inside one chat works, because Claude rebuilds the file with a version number each time, but it is rebuilding its own model, not yours.
Honestly, about as good as a quick junior blocking pass, and the people who tested it say the same thing in different words. We did not generate our own test models for this guide, so here is what three independent testers found, with links so you can check them:
Notice the pattern. Claude is good at what can be described as a count and a spacing (six drawers, shelves every 12 inches, two floors) and weak at what needs spatial judgment (where the door goes, whether you can reach the sink). That matches the most pointed criticism on the SketchUp forum thread where the connector was first discussed, where one user argued that language models “do not support 3D vision” and another called the whole thing burning “gazillions tons of AI tokens” to get a model of boxes and cylinders. That second one is harsh, but for a simple piece of furniture an experienced modeler is still faster by hand.
Where it does earn its place is the blank page. Getting from a brief to something on screen in under a minute lets you start reacting earlier, the same reason AI saves architects time on early options and not on construction documents. Give it real numbers, attach a floor plan to turn into a 3D model, and plan to measure and fix everything it gives you.
If you need Claude to work on your own model, the community route is the only one that does it. These servers have two halves: a Ruby extension that runs a small server inside SketchUp desktop, and a Python MCP server that Claude Desktop or Claude Code starts and that relays Claude’s tool calls over a local socket. Two projects are worth knowing about.


The original (left) has the stars; the newer fork-in-spirit (right) has the maintenance. Both captured October 10, 2026.
| mhyrr/sketchup-mcp | zinin/sketchup-mcp2 | |
|---|---|---|
| GitHub stars | 484 | 41 |
| Last commit | April 25, 2026 | September 26, 2026 |
| Tools | 10, incl. joinery (mortise and tenon, dovetail, finger joint) | 22, adds booleans, fillets, chamfers, layers, undo, viewport screenshots |
| Units | Not stated in the tools | Millimeters everywhere |
| Arbitrary Ruby (eval_ruby) | Yes, always on | Yes, on by default, can be switched off in Settings |
| License | README says MIT, no license file in the repo | MIT |
| Install | .rbz + uvx sketchup-mcp | .rbz from Releases + uvx sketchup-mcp2 |
If I were setting this up today I would pick sketchup-mcp2, despite the smaller star count. It is maintained, it has an undo tool, it wraps every edit in a single SketchUp undo step, and its get_viewport_screenshot tool (SketchUp 2026 and newer) lets Claude look at what it just built, which is the obvious fix for the “no 3D vision” complaint above. The original has not had a commit in five months. Setup for sketchup-mcp2, from its README:
uvx command..rbz from the project’s Releases page and install it in SketchUp under Window, Extension Manager, Install Extension. Restart SketchUp.claude_desktop_config.json or a .mcp.json for Claude Code, then restart Claude:{
"mcpServers": {
"sketchup": {
"command": "uvx",
"args": ["sketchup-mcp2"],
"env": { "SKETCHUP_MCP_HOST": "127.0.0.1", "SKETCHUP_MCP_PORT": "9876" }
}
}
}Two practical warnings. You need SketchUp desktop, and SketchUp Go is “iPad & web only” with no extensions, so this means Pro or Studio. And SketchUp’s Ruby runs on the UI thread: a large eval_ruby call freezes the whole app until it returns, which the README says itself. Ask for big models in steps.
Safe enough on a laptop you control, if you understand one thing: both servers include a tool that runs any Ruby code Claude sends, inside SketchUp, with your user’s permissions. Ruby in SketchUp can read and write files, open network connections and run shell commands. I checked the code rather than trust the READMEs.
127.0.0.1 on port 9876 (su_mcp/main.rb, line 44), so only programs on your own computer can reach it, and there is no password. The eval_ruby handler calls Ruby’s eval on the code it receives (line 1835). The comment above it says “Create a safe binding for evaluation”, but the binding is a copy of the top-level one. That is not a sandbox; it only keeps local variables tidy.127.0.0.1:9876 with no authentication, lets you change the host, and prints a warning if you bind it to anything that is not local. Its README is upfront that eval_ruby is enabled by default and that binding to 0.0.0.0 exposes it to your whole network.So: keep the local address, never expose port 9876 on office Wi-Fi, leave Claude’s per-tool approval on so you see each Ruby snippet before it runs, and switch Ruby evaluation off in sketchup-mcp2’s settings if the typed tools cover what you do. Do not run either server with Claude Code’s --dangerously-skip-permissions flag on a machine that holds client files.
Yes, and it is the route nobody markets because there is nothing to sell. Ask Claude for a Ruby script, open Extensions, Developer, Ruby Console in SketchUp desktop (it moved out of the Window menu in SketchUp 2021), paste and run it. It is great for repetitive chores: renaming tags, placing a component every 600 mm along an edge, exporting each scene to a file. The catch is quality control. When a user posted a ChatGPT written extension on the SketchUp forum, two of the community’s best known Ruby API experts found it broke basic extension rules, got a SketchUp class name wrong and skipped the start_operation wrapper that makes a change undoable in one step. That review is from 2022 and models have improved a lot, but the lesson holds: ask Claude to wrap changes in an operation, and run scripts on a copy of the file first. It needs no extension and no server, which also makes it the safest of the three.
| Product | Price (US, October 2026) | What it gets you here |
|---|---|---|
| Claude Free | $0 | Connectors, including the SketchUp one, with tight usage limits |
| Claude Pro | $20 a month, or $17 billed annually | Higher limits, plus Claude Code for the MCP route |
| SketchUp, no plan | $0 | Up to 30 connector models, a free Trimble ID |
| SketchUp Go | $10.75 a month billed annually | Uncapped connector models, iPad and web only, no extensions |
| SketchUp Pro | $33.25 a month billed annually | Desktop app and extensions, needed for the MCP route |
| SketchUp Studio | $71.58 a month billed annually | Pro plus V-Ray and Scan Essentials, Windows only |
Prices are from Claude’s pricing page and SketchUp’s plans page, excluding tax. That “uncapped on Go” line comes from Trimble’s Chris Cronin in an engineering.com interview, who said there is “currently no limitation” for paid SketchUp users. “Currently” is doing some work in that sentence.
No, and Trimble is clear about it: the connector “models geometry, not renderings.” What you get is a clean, untextured SketchUp model, which is the right starting point for a designer but not something you can show a client. The usual next step is a render, and you have a few options: SketchUp’s own AI Render, a classic engine like V-Ray, or an AI render plugin. Our comparison of the best AI SketchUp plugins covers the field, and AI architectural rendering tools covers the ones that work outside SketchUp.
This is where I should disclose our part. MeltFlex has a free SketchUp AI rendering plugin that captures your current view and turns it into a styled, photoreal render in about twenty seconds, and the same engine can turn a 3D draft into a render in the browser if you would rather export a screenshot. A Claude built massing model plus a render pass is a reasonable way to get from a brief to a first client image in an afternoon. It does not fix the missing doors; you still have to.

Our own extension inside SketchUp: Capture View sends the current model view to MeltFlex for a render. Claude does the geometry; something else has to do this part.
For early massing, furniture blocking and repetitive geometry, yes, try the official connector; it costs nothing for the first 30 models and takes two minutes. For working on real projects, the official connector is the wrong tool because it cannot touch an existing file, and the community servers are the right tool only if you are comfortable with an extension that can run arbitrary code. For anything a builder or cabinetmaker will measure, not yet.
The deeper limitation is the one every tester hit: Claude builds what you said, not what you meant. It will give you shelves every 12 inches and forget the bedroom door. That is a reason to write better briefs, with dimensions, clearances and adjacencies spelled out, and our Claude prompts for interior design are a decent template for that. It is not a reason to expect the next model to replace the person checking the plan.
If SketchUp is only one piece of your setup, the same idea works elsewhere: MCP servers for architects in Claude Code covers Blender, Rhino and Grasshopper, MeltFlex MCP lets Claude redesign a photo of a real room, and ChatGPT plugins for architects covers the other assistant, which has no SketchUp plugin at all; connecting ChatGPT to SketchUp covers the Codex workaround and our test of a ChatGPT written Ruby script, and connecting Gemini to SketchUp covers Google’s Antigravity and our test of Gemini 4 Argon. If your drawings live in AutoCAD instead, AutoCAD MCP covers Autodesk’s own server and our test of Claude drafting a floor plan.
Read on October 10, 2026: Trimble’s help page for the connector (updated August 21, 2026), Trimble’s launch release (April 28, 2026), Trimble’s connector blog post (May 8, 2026), Anthropic’s announcement, the Claude directory listing, the engineering.com interview, the MindStudio and Focused SketchUp tests, and two SketchUp forum threads, all linked above. The community server facts come from cloning mhyrr/sketchup-mcp and zinin/sketchup-mcp2 on the same day; star counts and commit dates move.
What we did not do: we stopped at the Trimble sign-in and did not generate models with the connector, and we did not install the community servers on a client machine. Every statement about model quality is someone else’s test, linked. Two things conflict between Trimble’s own sources and we have shown both: the connector’s tool names, and whether the free cap of 30 models resets monthly. We will update this page when Trimble ships version 2 of the connector, which its help page says will expand what it can do.
Yes. Since April 28, 2026 there is an official Trimble SketchUp connector in Claude's connector directory. You add it under Customize, then Connectors, sign in with a Trimble ID, and Claude can build a new SketchUp model from a text prompt or a reference image and hand you a .skp file to download. There are also community MCP servers on GitHub that connect Claude to the SketchUp desktop app running on your own computer.
The connector itself costs nothing extra. Without a paid SketchUp plan, Trimble lets you save up to 30 models, after which you need a paid SketchUp subscription; one interview with Trimble describes the cap as 30 files per month, so check the current terms. Claude is billed separately, and Anthropic lists connectors on its free plan as well as on Pro, which is $20 a month or $17 a month billed annually.
Not with the official connector. Trimble's help page says Claude can only create .skp files and cannot edit or render an existing one. To have Claude change a model you already have, you need a community MCP server such as sketchup-mcp or sketchup-mcp2, which talks to SketchUp desktop on your machine and can move, recolor, delete and add geometry in the open file.
Not for the official connector, which builds the model in a cloud SketchUp session, and the file opens in SketchUp for Web, Desktop, iPad or iPhone. For the community MCP servers you need SketchUp desktop, because they install as a Ruby extension. SketchUp Go is iPad and web only and does not include extensions, so in practice that means Pro ($33.25 a month billed annually) or Studio.
No. The connector models geometry, not renderings, and Trimble says so on its own help page. For a photoreal image you still need a render step: SketchUp's own AI Render, a render engine such as V-Ray, or an AI render plugin. MeltFlex has a free SketchUp extension that turns the current view into a styled render in about twenty seconds.
It depends on how you set it up. Both popular community servers listen only on your own computer (127.0.0.1, port 9876) by default and have no password, and both include an eval_ruby tool that runs any Ruby code inside SketchUp, which means full access to your files. Keep the default local address, never bind it to 0.0.0.0 on a shared network, approve each tool call in Claude, and in sketchup-mcp2 switch off Ruby evaluation in Settings if you do not need it.
Not an official one. Trimble has said Claude is the only third party AI assistant it officially supports, and there is no SketchUp plugin in ChatGPT's Plugin Directory. The community MCP servers speak the open Model Context Protocol, so other MCP clients can use them: the ChatGPT desktop app's Codex mode can run them, although their setup guides are written around Claude.
Good enough for a first massing or blocking model, not good enough to hand to a builder. Independent tests found that room shells and repeated elements such as shelving come out quickly, while exact dimensions, real products, materials and circulation are weak: a one bedroom apartment came back with no door into the bedroom or the bathroom. Treat the output as a sketch you will measure and fix.