Claude·Coming soon

Ask Claude to work on your model.

Connect MeshOptimiser to Claude and describe the job in plain words. Claude looks at the scene, finds what is heavy and does the clean-up in the app, in front of you. Anything that changes the model asks first, and every change can be undone.

How it works Read the docs

Lighten the gearbox

This gearbox is too heavy for the web. Take the bolts out of the way, then get the whole thing under 300,000 triangles.
I’ll start by looking at what is in the scene.
- scene_summary95 parts, 646,064 triangles
- find_fasteners48 bolts, nuts and washers selected
- hide_parts48 parts hidden
The fasteners are out of the way. To get under 300,000 triangles I need to take triangles from the parts that can spare them.
- fit_to_budgettarget 300,000
Waiting for you to allow it in MeshOptimiser
Claude wants toReduce the whole scene to 300000 trianglesThe parts that can best spare triangles give them up. Undo (Ctrl+Z) takes it back.
Don’t allowAllow

646,064 → 299,984 triangles, 53.6% fewer
Done: 299,984 triangles. Both steps are in the app’s undo history, so Ctrl + Z takes them back.

Reply to Claude…

An example session on the Gearbox Assy. The numbers are what the app returned. On a wide screen the 3D part beside it is a light copy of the model, made for this page.

How it works

Three steps, then just ask.

01
Switch it on
In MeshOptimiser open Settings, choose Claude, and turn on Let Claude connect. A small “Claude connected” pill shows in the top bar while it is on.
02
Add it to Claude
Once, in a terminal on the same computer. This points Claude at the app. Nothing is installed.
03
Ask
Describe the job in plain words. Claude calls the app’s tools one at a time and tells you what it did.

Add it to Claude: claude mcp add --transport http meshoptimiser http://localhost:4242/mcp

The command is for Claude Code. Another program that can add an HTTP MCP server takes the same address: http://localhost:4242/mcp. If the launcher printed a different port, use that number.

What Claude can do

The app’s own tools, in Claude’s hands.

Look

See the scene as you see it.

scene_summaryThe file, parts, triangles, size, view mode and explode state.
list_partsEvery part with its triangles, size and colour; sorted, filtered, paged.
get_selectionWhat is selected right now.
check_modelA health check in one call: where the weight is, what is tiny, thin, hidden or drawn twice, the unit, and what to do first.
optimisation_reportThe file as it was opened against now: triangles, parts, draw calls, memory, file size, with the change in percent.
estimate_export_sizeWhat a GLB would weigh, plain and with Draco, against the app’s limits for a web page, Shopify, AR Quick Look and a phone app.
list_materialsThe materials, with colour and how many parts use each.
list_recipesYour saved Smart optimise recipes.

Pictures and film

Quick looks, and clean pictures for a client or a report. Files are saved on your computer.

screenshotA quick look at the viewport, so Claude can see what you see.
render_imageA big, smooth picture up to 8192 px: one or several angles, clay or solid, white, dark or transparent background. One file each, saved as PNG.
turntable_videoOne slow turn round the model, saved as a video.

Show you around

Select, hide, turn and explode. Nothing is changed, so none of it asks.

select_partsSelect by id or part of a name; add or remove.
select_allSelect every visible part, or invert the selection.
hide_partsHide parts.
isolate_partsShow only these parts.
show_allBring everything back.
frame_selectionFly to the selection.
set_camera_viewPerspective, top, front, side, or fit the model.
set_view_modeSolid, wireframe, x-ray, heat, clay or CAD.
set_explodePull the parts apart along any axes, 0 to 300%.
set_gridShow or hide the grid.

Find things

Questions with an answer.

find_fastenersBolts, screws, nuts and washers found by their shape, whatever they are called; counts per kind and thread size.
find_hidden_partsParts nobody can see from outside, such as screws in a housing; selected so you can check them first.
find_stacked_copiesParts drawn twice in the same place; the extra copies are selected.
measure_partsThe distance between two parts, and the gap between their boxes.
select_similarThe other copies of a shape: every washer of one kind.
select_by_colourEvery part with the colour of the chosen ones, or of a colour you give.
select_by_materialEvery part that uses a material.
list_groupsThe groups in the tree.

Make it lighter

Each one asks you first, and each one is a single undo step.

smart_optimiseThe app’s whole clean-up in one run and one undo: light, balanced or strong.asks
run_recipeYour own saved settings: the same clean-up you ran last time, on this model.asks
decimateReduce the triangles of chosen parts, to a target or by a share.asks
fit_to_budgetReduce the whole scene to a triangle budget.asks
fill_holesClose bolt holes, slots and pockets up to a size.asks
remove_hidden_facesDelete faces that can never be seen from outside.asks
repair_meshJoin doubled vertices, remove empty triangles, turn faces the same way.asks
clean_upRemove empty parts, share duplicate geometry, repair bad triangles.asks
merge_partsMerge parts into one mesh.asks
merge_by_colourOne mesh per colour.asks
split_partsBreak a mesh into its separate pieces.asks
smart_fitReplace a part with a box, a cylinder, a few boxes or blocks of the same size.asks
untriangulateFewer triangles on flat faces, with no change of shape.asks

Tidy and arrange

Names, groups and positions.

list_libraryThe app’s library of standard parts: bolts, nuts, pipes, profiles, gears and more.
add_library_partAdd a standard part to the scene.asks
rename_partsRename by id, or find and replace, prefix and suffix.asks
group_partsPut parts in a group.asks
ungroupDissolve a group.asks
duplicate_partsCopy parts.asks
transform_partsMove, turn and scale parts.asks
recenter_modelPut the middle of the model at the origin.asks
align_to_floorStand the model on the floor.asks

Delete

Always asks, even when you switch asking off for the rest.

delete_partsDelete chosen parts.asks
remove_small_partsDelete every part under a size.asks

Files

On your own computer; nothing is uploaded.

open_fileOpen a model from a path on this computer.
save_sceneSave the scene as a scene file, edits included, before a drastic step.
export_modelSave a GLB, glTF, FBX, USDZ, OBJ or STL, or use a preset for the web, AR, Unreal, Unity or printing.

Know-how

The app’s own knowledge, on demand. Answered without the app being open.

search_docsSearch the playbooks and the help articles by words or by a symptom.
read_docRead one article or playbook in full.

Scenes and history

The tabs and the undo history.

scene_tabsList the scene tabs, switch, open a new one.
undoTake back the last steps.
redoDo them again.

Pictures for your client

Ask for a render, get a clean picture.

When the model is light enough, Claude can make the pictures that go with it: a set of angles on a plain background, a cut-out with nothing behind it, the model exploded. They are saved as PNG files on your computer, and Claude looks at a preview of each to check the angle before it tells you they are ready.

MeshOptimiser: The Gearbox Assy exploded to 55%, solid, on a dark background. Made with render_image. — The Gearbox Assy exploded to 55%, solid, on a dark background. Made with render_image.

MeshOptimiser: Four angles in one request: perspective, front, side and top, in clay on white. — Four angles in one request: perspective, front, side and top, in clay on white.

Big and smooth: Up to 8192 pixels a side. Each picture is drawn at twice its size and scaled down, so the edges are clean.
A set of angles: Perspective, front, side and top in one request: one file for each, one sheet for Claude to look at.
Your background: White, light, dark, grey or black, exact colours, or transparent for a cut-out.
The look you want: Solid, clay (the shape without colour), CAD, wireframe, x-ray, or the heat view that shows where the triangles are.
Before and after: Render the model as it is, optimise it, render again with the same camera, mode and size.
Framed for you: The model fills the picture whatever its shape, and the grid is left out.

It arrives knowing the job

The know-how of an experienced user, built in.

Claude does not start from nothing. The app hands it what a person who has read every help article and done this for years knows: the order to work in, what each step costs, what is safe, and what to do when something fails.

Six playbooks

How to optimiseThe rules and the order: look first, tidy, remove what nobody sees, remove what nobody needs, close detail, replace filler, reduce last.
Recipes by goalThe tool calls for a web viewer, AR, a game engine, 3D printing, sending to a customer, a review, or a number and nothing else.
JudgementWhat makes a scene heavy, what each step costs in looks, which smart-fit shape to choose, when to ask.
The tools by jobEvery tool grouped by what you want to do, with its options and which one fits which job.
What is safeWhat can be undone, what asks you, what is never done without saying so.
When it failsConnection, refusals and results that are not what was expected, with a cause and a next step for each.

The help articles

About fifty of the app’s own help articles, one per tool and job: Smart optimise, fasteners, hidden parts, fill holes, fit to budget, formats and more. Claude searches them by words or by a symptom, and reads only the one it needs.

The same articles you can read on this site, so what Claude does and what the docs say never disagree.

Ready-made jobs

Optimise for the webTo a triangle target, a step at a time.
Lighten it in one goSmart optimise at a level, with a report.
Take the bolts outHide, simplify or delete.
Make it safe to sendRemove what reveals the design.
Review the sceneWhat is heavy and what could go, changing nothing.

About 2,000: tokens for the main playbook, read once at the start of a job
0: tokens for the help articles until Claude searches for one; the search returns short snippets, not articles
−23%: characters in a typical reply: replies are compact, not indented, measured on a 40-part list
1 call: for Smart optimise, instead of a dozen separate steps found by trial

Token counts are estimates at four characters to the token. How many a job takes depends on the model and on the job, so this is a way to spend fewer, not a promise of a percentage.

You stay in charge

Nothing changes without your say.

Claude works in your window, on your computer, and the app decides what it may do, not Claude.

It asks first: Anything that changes the model shows an Allow or Don’t allow prompt over the model. Looking, selecting, hiding and moving the camera do not.
Four switches: Settings › Claude has one switch each for changing the model, moving and renaming, deleting, and files. A switch that is off refuses the request, and Claude is told why.
Deleting always asks: Even if you turn asking off for everything else.
One undo each: Every change is a step in the app’s own history. Ctrl + Z takes it back, and so can Claude.
Off until you switch it on: One switch connects it, one switch ends it, and the top bar says when it is on. Settings lists what Claude asked for, what you answered and how long each request took. Every request is also written to the app’s console and to the window that runs it.

MeshOptimiser: The prompt that comes before every change to the model. — The prompt that comes before every change to the model.

MeshOptimiser: Settings › Claude: the connection, what Claude may do, and what it asked for. — Settings › Claude: the connection, what Claude may do, and what it asked for.

MeshOptimiser: The Claude badge in the top bar, and its dropdown. — The Claude badge in the top bar, and its dropdown.

Always in view

The badge in the top bar is a small control panel.

While Claude is connected, a badge sits at the right of the top bar. Click it for a dropdown with the numbers and the basic switches. For everything else, More opens Settings.

The state: Listening, working, or waiting for your answer, with how long it has been connected and what Claude asked for last.
The numbers: Requests, done, said no and failed this session, and the last three requests with how long each took.
The switches: Let Claude connect, ask before Claude edits, and always ask before deleting. Switch the connection off from here in one click.
The rest: Copy the connect command, open the console where every request is written, or open Settings › Claude with More.

What leaves the computer

The app talks to Claude only through a small server that listens on your own computer. Your model file is not sent anywhere.

Claude gets back what its requests return: part names, counts, sizes and the pictures it asks for, such as a screenshot of the viewport. Those pass through Claude the way anything you type to it does.

Saved files, exports and turntable videos go to the app’s exports folder on your computer.

Try asking

Plain words are enough.

Optimise this for the web, under 300,000 triangles, and tell me what you took out.
Check this model and tell me where the weight is.
Find all the bolts and hide them.
Get this under 300,000 triangles and tell me what you took out.
Show it exploded 50% and take a screenshot.
Which ten parts carry the most triangles?
Rename every part that starts with “body” to “Housing”.
Remove the hidden faces from the ten heaviest parts.
Find parts nobody can see from outside and show me before you delete them.
Make this safe to send to a customer.
Render four clean pictures of this on white for a client.

Questions

Before you try it.

What do I need?: MeshOptimiser running on your computer, with the app open in a browser tab, and Claude with MCP support: Claude Code, or any client that can add an HTTP MCP server.
Is it on by default?: No. The app does not listen for Claude until you switch on Let Claude connect, and it forgets the connection when you switch it off.
Does it work in the demo?: No. The hosted demo has no connection to Claude. Run the app on your own computer.
What if I want it to ask less, or not at all?: Switch off Ask before Claude edits. Deleting still asks unless you also switch off Always ask before deleting. Or turn a whole kind of edit off with its own switch.
Does Claude know how to optimise a model?: Yes. It comes with the know-how of an experienced user: six playbooks (how to optimise, recipes by goal, judgement, the tools by job, what is safe, what to do when something fails) and about fifty of the app’s help articles, one per tool and job. It reads the playbook before it starts, and searches the articles for anything it has not done before.
How does Claude know how far to go?: It checks the scene against the app’s own guidelines, the ones in the Export dialog: about 5 MB and 100,000 triangles for a web page, 15 MB for a Shopify product page, 10 MB and 100,000 triangles for Apple AR Quick Look, 25 MB and 200,000 triangles for a phone app. It estimates what the file would weigh before it exports, uses your saved recipes if you have them, and tells you the before and after from the app’s own report. If you give it a number, yours wins.
Will it save tokens?: It should: it works in fewer, better-chosen steps instead of finding the order by trial, one Smart optimise call stands in for a dozen, and every reply is compact (about a fifth fewer characters than an indented one). The playbook costs about 2,500 tokens, read once; the articles cost nothing until Claude searches for one. How many tokens a job takes still depends on the model and on you, so there is no promise of a percentage.
Can Claude make pictures of the result for a client?: Yes. It can render big, smooth pictures (up to 8192 pixels) from one or several angles, in clay or solid, on a white, dark or transparent background, and save them as PNG on your computer. It looks at a small preview of each to check the angle. It can also render the model before and after optimising with the same camera, for a before and after.
Can Claude break my model?: Not past the undo history. Every change is a step you can take back, and your file on disk is only changed when you export.

Run it on your own machine.

Free and open source under the MIT licence. Windows and macOS; your files never leave the computer.

Download v0.21.0 Try the demo View on GitHub