solidworks-mcp
Automate SolidWorks CAD modeling and inspection: create parts/assemblies/drawings, sketch and build features, modify parameters/materials, and export results.
Inspect and measure active models: document info, feature tree, bounding box, mass properties, screenshots, model checks, and measurements.
Create and configure parts, assemblies, and drawings; save and export documents.
Sketch with lines, rectangles, circles, arcs, polygons, slots, ellipses, and splines; offset/convert/fillet sketch entities; add dimensions and relations; fully define sketches.
Build and modify features: extrude/cut, revolve, rib, sweep, loft, holes, fillet, chamfer, shell, patterns, mirror, and reference planes.
Work with sheet metal: base/edge flanges and flat-pattern DXF export.
Manage configurations, materials, dimensions, suppression, equations, custom properties, undo/delete, and zoom-to-fit.
Work with assemblies: insert components, add mates, and check interference.
Work with drawings: create standard views and insert model dimensions.
Select planes/faces/edges and convert between model and sketch coordinates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@solidworks-mcp make a 40mm cube and cut a 10mm hole through the top"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
solidworks-mcp
An MCP server that lets an AI assistant model parts in SolidWorks. The assistant sketches, extrudes, cuts, measures and exports through the SolidWorks COM API, in the SolidWorks window you have open, so you can watch and take over at any point.
Dimensions are always millimetres and degrees.
Works with SolidWorks in any language.
Starts SolidWorks if it is not running.
Commands run one at a time; if SolidWorks stops answering you get an error instead of a hang.
Requirements
Windows with SolidWorks installed and licensed
Python 3.11 or newer
An MCP client (Claude Code, Claude Desktop, Cursor, ...)
Developed and tested on SolidWorks 2026. The API calls used go back many releases, but older versions have not been tested.
Related MCP server: solidworks-mcp
Install
One-click installer (Windows)
Download SolidWorks-MCP-Setup.exe and run it. It needs no administrator rights and sets up everything for Claude Code:
uv and this server, pinned to the latest release (no Python or Git needed beforehand)
Claude Code, if it is not installed yet
a work folder,
Documents\SolidWorks-MCP, with.mcp.json, design instructions for the assistant (CLAUDE.md), the server's tools pre-approved, and aprojectsfolder for your parts
Then double-click SolidWorks-MCP on the desktop: the control panel opens (see below); Start Claude opens Claude Code in the work folder, which starts the server. The first time, it asks you to log in (Pro, Max, Team or Enterprise plan) and to trust the folder. The shortcut checks for a new release once a day; Start menu > SolidWorks-MCP > Repair fixes a broken install, and uninstalling keeps your work folder.
The installer is not code-signed, so Windows SmartScreen may show Windows protected your PC: choose More info > Run anyway.
To build it yourself: bash installer/build.sh (needs NSIS). Pushing a v* tag builds it on GitHub Actions and attaches it to the release.
Manual install
The package is on PyPI as solidworks-mcp-server. With uv, nothing needs installing by hand. Add the server to your MCP client configuration:
{
"mcpServers": {
"solidworks": {
"command": "uvx",
"args": ["solidworks-mcp-server"]
}
}
}With pip:
pip install solidworks-mcp-serverand use "command": "solidworks-mcp" with no arguments in the client configuration (solidworks-mcp-server works too).
The latest code from GitHub, before it is released: "args": ["--from", "git+https://github.com/MatteoBaisini/solidworks-mcp", "solidworks-mcp"].
From a clone, run install.bat (it creates .venv and installs the server in it), then use the full path of .venv\Scripts\solidworks-mcp.exe as the command.
SolidWorks and the server must run with the same privileges: do not run either one as administrator.
CLI Tools (doctor & install)
Diagnostics (
doctor): verify SolidWorks COM connectivity, permissions, and default templates:solidworks-mcp doctorAutomated Client Setup (
install): configure Claude Desktop, Cursor, or Windsurf with automatic backups of existing configurations:solidworks-mcp install --client claude # or cursor, windsurf, all
Control panel
solidworks-mcp-panel (or solidworks-mcp panel --workspace <folder>) opens a small window for people who are new to CAD or to Claude Code. In English or Italian, following the Windows language, it:
starts Claude Code in the work folder, optionally with a first request;
shows live status: whether SolidWorks is running and which document is active, and whether Claude is waiting, thinking, designing (with the current step in plain words) or asking for a permission. It also warns when SolidWorks stops answering;
lists every step with its result and duration;
fills in requests from part templates (plate, L bracket, flange, spacer, box) and offers one-click requests (check, show, export, save a new version, undo);
has a short guide, the
doctorchecks, and buttons that open the projects folder and the last saved part.
The status comes from Claude Code hooks that the panel adds to <work folder>\.claude\settings.local.json, keeping your other settings. They append one line per event to %LOCALAPPDATA%\solidworks-mcp\activity.jsonl. The panel reads SolidWorks through COM read-only and never starts it. Nothing leaves the PC, and the MCP server itself is unchanged.
Tools
Every tool declares standard MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), allowing clients to automatically authorize safe read and inspection calls while prompting for changes.
Group | Tools |
Information |
|
Documents |
|
Assemblies |
|
Drawings |
|
Configurations |
|
Selection |
|
Sketch |
|
Sketch constraints |
|
Features |
|
Finishing |
|
Sheet Metal |
|
Patterns |
|
Material |
|
Parameters |
|
Editing |
|
Optional |
|
A typical part is new_part → select_plane → start_sketch → sketch tools → extrude, then select_face_at_point → start_sketch → cut_extrude for pockets, hole for drilled holes, fillet / chamfer for the edges and set_material for a real mass.
How the assistant points at things:
Sketch tools take sketch coordinates (x, y).
start_sketchreports how the sketch axes map onto the model, andconvert_pointconverts single points.Faces, edges and vertices (fillet, chamfer, shell, hole, measure, ...) are picked by a point lying on them, in model coordinates [x, y, z]. The pick is geometric, so it also finds entities hidden in the current view.
list_facesandlist_edgeslist them with a point on each, their type, size and the feature that made them, so the assistant does not have to guess.Features and sketches are referred to by the names in the feature tree, which every tool that creates one returns.
Extrusions and cuts can go blind, midplane, through all or up to a face, in two directions, with draft, and as thin walls.
holedrills plain, counterbored or countersunk holes, sized by diameter or by metric screw size (ISO 273 clearance, tap drill, ISO 4762 / ISO 10642 counterbores and countersinks). Tapped holes can carry a cosmetic thread (thread=True); threads are not modelled as geometry.Reference planes can be offset from a plane, at an angle around an axis or an edge, or through three vertices;
create_axisadds an axis through a cylindrical face, an edge or two planes.Existing parts:
open_documentopens one,edit_sketchreopens a sketch,edit_featurechanges an extrusion's depth or end condition, andsave_document(new_version=True)saves the next version without overwriting the previous one.Linear and circular patterns run along the model axes (a hidden reference axis is added the first time) or around an edge.
Prompts & Resources
In addition to tools, the server exposes standard MCP prompts and live read-only resources:
Prompt
design_part: Step-by-step guidance and recommended workflow for mechanical design from initial plane selection to feature creation, inspection, and export.Resource
solidworks://active/info: Live status, document title, file path, document type, and SolidWorks revision.Resource
solidworks://active/feature-tree: Current design feature tree with names and types.Resource
solidworks://materials: Configured material databases and categories.
Configuration
Settings live in a TOML file; every key is optional. Copy config.example.toml, which documents all of them, and tell the server where it is in one of these ways (first match wins):
--config <path>on the command linethe
SOLIDWORKS_MCP_CONFIGenvironment variablesolidworks-mcp.tomlin the server's working directory%APPDATA%\solidworks-mcp\config.toml
For example, to keep every part in a projects folder and export STEP and STL next to the models:
[projects]
directory = "projects" # relative to this file, or an absolute path
[export]
formats = ["step", "stl"]
directory = "../{format}"With a projects folder set, the assistant saves each part as <project>/cad/<project>_v<N>_<description>.SLDPRT inside it, creating the folders and numbering the versions, without being told where to save each time. export_document then writes <project>/step/<part>.step and <project>/stl/<part>.stl.
A clone of this repository comes with a projects/ folder ready for this; its contents are ignored by git, so your parts are not published.
Command line
solidworks-mcp [--transport stdio|sse|streamable-http] [--port 8000] [--config PATH]The default transport is stdio, which is what MCP clients expect when they start the server themselves. sse and streamable-http serve on http://127.0.0.1:<port> (/sse or /mcp) and are reachable from this PC only.
Security
execute_solidworks_macro lets the assistant run arbitrary Python code on your PC, with your privileges. It exists because the dedicated tools do not cover everything (assemblies, drawings, sheet metal, ...), but it is disabled unless you turn it on:
[macro]
enabled = trueEnable it only if you trust the assistant and everything it reads. The SOLIDWORKS_MCP_ALLOW_MACRO environment variable (1 or 0) overrides the file.
The assistant works in your live SolidWorks session, on whichever document is active. Save your own work before letting it model, and keep an eye on which document is in front.
Troubleshooting
"SolidWorks is not running (or cannot be reached)" while it is open: SolidWorks or the server is running as administrator and the other is not.
"got no answer from SolidWorks within 90 s": a dialog is usually waiting in the SolidWorks window, or SolidWorks is still starting. Answer the dialog and retry; raise
command_timeout_sif your models are slow to rebuild."Default part template not set": set one in SolidWorks under Options > File Locations / Default Templates.
Development
git clone https://github.com/MatteoBaisini/solidworks-mcp
cd solidworks-mcp
python -m venv .venv
.venv\Scripts\pip install -e .[dev]
.venv\Scripts\pytestThe tests do not need SolidWorks; tests/test_integration.py also runs against SolidWorks when it is open. For an end-to-end check through the MCP protocol:
.venv\Scripts\python examples\smoke_test.py # read only
.venv\Scripts\python examples\smoke_test.py draw # creates a plate with a hole
.venv\Scripts\python examples\smoke_test.py all # part, configurations, drawing, assembly, sheet metal
.venv\Scripts\python examples\smoke_test.py assembly # or any of: part config drawing assembly sheetmetalThe groups save their files in a temporary folder and close every document they open. The exit code is the number of failed calls.
License
Available Tools
86 toolsactivate_configurationAIdempotent
Activates an existing configuration by name in the active part or assembly.
Inputs: name (required). Returns: result
activate_documentAIdempotent
Makes an open document the active one (brings its window to the front), by title, file name or full path as shown by list_open_documents. Every other tool works on the active document.
Inputs: name (required). Returns: result
add_configurationB
Adds a new configuration to the active part or assembly document and activates it.
Inputs: name (required), comment, description. Returns: result
add_equationA
Adds a global variable or an equation and rebuilds. Names go in double quotes, e.g. '"width" = 80' (global variable), '"D1@Boss-Extrude1" = "width" / 2' (drives a dimension). Numbers without units take the document units.
Inputs: equation (required). Returns: result
add_mateA
Adds a geometric mate constraint between two components in the active assembly.
Specify entities either by 3D points [x, y, z] mm in assembly coordinates lying on the faces/edges, or by entity names (e.g. 'Plane1@Part1-1@Assembly1'). Supported mate types: coincident, concentric, parallel, perpendicular, tangent, distance, angle. The components move to satisfy the mate. Replaces the current selection.
Inputs: mate_type (required), flip, alignment, angle_deg, +5 more. Returns: result
add_sketch_dimensionA
Adds a driving dimension to the open sketch and sets it to 'value' (mm, or degrees for angles).
(x, y): a point on the entity (sketch coordinates). One entity: length of a line, diameter of a circle, radius of an arc. With (x2, y2) on a second entity: distance between them, or the angle between two lines. (text_x, text_y) places the text (default: next to the entity).
Inputs: x_mm (required), y_mm (required), value (required), x2_mm, +3 more. Returns: result
add_sketch_relationB
Adds a geometric relation between sketch entities of the open sketch.
points: [[x, y], ...] one point (sketch coordinates) on each entity involved. vertex: optional, one flag per point; true picks the sketch POINT there (an end point or centre) instead of the line/arc, as needed by coincident and midpoint (point first).
Inputs: points (required), relation (required), vertex. Returns: result
base_flangeA
Creates a sheet metal base flange from the last sketch (the one open, or the last closed one): an open chain of lines gives a bent sheet extruded depth_mm, a closed profile gives a flat tab. Adds the Sheet-Metal and Flat-Pattern features to the tree. The sheet grows on one side of the sketch lines (the other with reverse_thickness=True).
Inputs: depth_mm, thickness_mm, bend_radius_mm, reverse_thickness. Returns: result
chamferA
Bevels edges. edge_points / face_points as for fillet. Default: distance_mm at angle_deg (45 = equal sides). With distance2_mm > 0 the two sides are distance_mm and distance2_mm (angle ignored); flip swaps the sides of an unequal chamfer.
Inputs: distance_mm (required), flip, angle_deg, edge_points, +2 more. Returns: result
check_interferenceARead-onlyIdempotent
Checks the active assembly for volumetric interferences (collisions) between components.
Inputs: no named parameters. Returns: result
check_modelARead-onlyIdempotent
Checks the active part for rebuild errors, multiple bodies, and geometry faults.
Inputs: no named parameters. Returns: result
circular_patternA
Repeats features (names from get_feature_tree) around an axis: count copies in total (original included), spread evenly over angle_deg. axis: a model axis through the origin, or "edge" to turn around the circular or straight edge through axis_edge_point ([x, y, z] in mm, e.g. on the rim of a central hole). The first use of a model axis adds a hidden reference axis "Axis Z (MCP)" (X, Y) to the tree.
Inputs: count (required), features (required), axis, reverse, +2 more. Returns: result
close_documentADestructive
Closes a document (by title, file name or path; empty = the active one). With unsaved changes it refuses, unless save=True (saves over its own file first, which must be inside the projects folder) or discard_changes=True (the unsaved changes are LOST).
Inputs: name, save, discard_changes. Returns: result
convert_entitiesA
Projects edges of the model into the open sketch (Convert Entities): all the edges of each face with a point in face_points, and each edge with a point in edge_points ([x, y, z] in mm, model coordinates). The new sketch entities follow the model when it changes.
Inputs: edge_points, face_points. Returns: result
convert_pointARead-onlyIdempotent
Converts a point between model coordinates and the coordinates of the open sketch. to="sketch": (x, y, z) is a model point, returns its sketch (x, y) and its distance from the sketch plane. to="model": (x, y) is a sketch point (z ignored), returns the model point.
Inputs: x_mm (required), y_mm (required), to, z_mm. Returns: result
create_axisA
Creates a reference axis, e.g. for a circular pattern, a revolve or an angled plane: face_point = a point on a cylindrical or conical face (its axis, e.g. the axis of a hole); edge_point = a point on a straight edge; or planes = two plane names / "front", "top", "right" (their intersection). name renames it. Returns its name.
Inputs: name, planes, edge_point, face_point. Returns: result
create_planeA
Creates a reference plane and returns its name, to use with select_plane. Three modes:
offset (default): parallel to 'reference' ("front", "top", "right" or a plane name) or to the planar face through face_point ([x, y, z] mm), offset_mm away; flip=True for the other side. angle: angle_deg > 0 turns the plane by that angle from 'reference' (or the face) about an axis lying in it or parallel to it: axis = "x", "y", "z" (model axes) or the name of a reference axis, or axis_edge_point = a point on a straight edge. flip reverses the angle. through_points: three vertices [[x, y, z], ...] of the part (corners), in mm. Using a model axis the first time adds a hidden reference axis to the tree.
Inputs: axis, flip, angle_deg, offset_mm, +4 more. Returns: result
cut_extrudeA
Extruded cut (holes, pockets) with the last sketch. through_all=True goes right through (depth_mm ignored). reverse flips the direction; flip_side removes the material OUTSIDE the profile. up_to_point ([x, y, z] in mm on a face) cuts up to that face instead. depth2_mm > 0 also cuts that far in the opposite direction. draft_angle_deg tapers the walls (inwards, or outwards with draft_outward=True).
Inputs: reverse, depth_mm, depth2_mm, flip_side, +4 more. Returns: result
delete_equationBDestructive
Deletes the equation with that index (see get_equations).
Inputs: index (required). Returns: result
delete_featureBDestructive
Deletes a feature from the tree by name (see get_feature_tree).
Inputs: name (required). Returns: result
delete_sketch_entityADestructive
Deletes sketch entities of the open sketch: one [x, y] point on each, in sketch coordinates. Their relations and dimensions are deleted with them.
Inputs: points (required). Returns: result
draftA
Tilts faces by angle_deg (draft for moulding or casting), pivoting about a neutral plane: neutral_plane = "front", "top", "right" or a plane name, or neutral_face_point = a point on a planar face of the part (e.g. the parting face). face_points: a point on each face to tilt ([x, y, z] mm, model coordinates; see list_faces). flip reverses the pull direction.
Inputs: angle_deg (required), face_points (required), flip, neutral_plane, +1 more. Returns: result
edge_flangeA
Bends a flange of length_mm along a straight edge of a sheet metal part (made with base_flange): edge_point_mm is a point [x, y, z] in mm on that edge, or the edge selected with select_edge_at_point is used. The flange is as wide as the edge; radius_mm = 0 uses the bend radius of the part. Replaces the current selection.
Inputs: length_mm (required), angle_deg, radius_mm, edge_point_mm. Returns: result
edit_featureADestructiveIdempotent
Changes an existing extrusion or extruded cut (name from get_feature_tree) and rebuilds: depth_mm, end_condition (blind / through_all / midplane), reverse (direction), depth2_mm (second direction, 0 removes it). Only the values given are replaced. For other features change their dimensions with get_dimensions / set_dimension.
Inputs: name (required), reverse, depth_mm, depth2_mm, +1 more. Returns: result
edit_sketchA
Reopens an existing sketch (name from get_feature_tree, e.g. "Sketch1") to change it with the sketch tools; a sketch already open is closed first. Close it with end_sketch: the features built on it then update.
Inputs: name (required). Returns: result
end_sketchA
Closes the open sketch without creating a feature.
Inputs: no named parameters. Returns: result
export_documentADestructiveIdempotent
Exports the active document to exchange formats, next to the document or in 'directory'. Existing files with the same name are replaced.
formats: e.g. ["step", "stl"]; omit to use the formats set by the user in the configuration (STEP by default). Supported: step, stp, iges, igs, x_t, stl, 3mf, pdf, png, dxf, dwg (pdf, dxf and dwg for drawings). directory: absolute, or relative to the folder of the document; "{format}" is replaced by the format name. Omit to use the configured directory. Created if missing. Files are named after the document. The open document is left untouched.
Inputs: formats, directory. Returns: result
export_flat_patternADestructiveIdempotent
Exports the flat pattern of the active sheet metal part to a DXF file. Existing files with the same name are replaced. path: absolute path or relative filename for the DXF export. Omit to export next to the part.
Inputs: path, remove_bends. Returns: result
extrudeA
Extrudes the last sketch as a solid (closing it automatically if open).
end_condition: blind = depth_mm on one side; midplane = depth_mm split on both sides; through_all = through the existing solid; up_to_surface = up to the face through up_to_point ([x, y, z] in mm, model coordinates). depth2_mm > 0 also extrudes that far in the opposite direction (not with midplane). draft_angle_deg tapers the sides (inwards, or outwards with draft_outward=True). thin_wall_mm > 0 makes a thin wall of that thickness along the profile instead of filling it; open profiles (e.g. a chain of lines) are then allowed. merge=False keeps the result as a separate body.
Inputs: merge, reverse, depth_mm, depth2_mm, +5 more. Returns: result
filletA
Rounds edges with a constant radius. edge_points: a point on each edge ([x, y, z] in mm, model coordinates); face_points: a point on each face whose edges are all rounded. Edges tangent to the chosen ones are rounded too.
Inputs: radius_mm (required), edge_points, face_points. Returns: result
fully_define_sketchA
Adds the relations and dimensions (measured from the sketch origin) that the open sketch needs to be fully defined, so it keeps its shape and can be edited later through its dimensions (get_dimensions / set_dimension).
Inputs: no named parameters. Returns: result
get_active_document_infoARead-onlyIdempotent
Name, path and type of the active SolidWorks document, and the SolidWorks version. Starts SolidWorks if it is not running.
Inputs: no named parameters. Returns: result
get_bounding_boxARead-onlyIdempotent
Bounding box of the solid bodies of the active part: min/max on X, Y, Z and overall size, in mm.
Inputs: no named parameters. Returns: max_mm, min_mm, size_mm
get_custom_propertiesBRead-onlyIdempotent
Custom properties of the active document (description, part number, ...), as used in BOMs and title blocks.
Inputs: no named parameters. Returns: result
get_dimensionsARead-onlyIdempotent
Dimensions of a feature or sketch (or of the whole part when 'feature' is empty), with their full names (e.g. D1@Boss-Extrude1) and values in mm or degrees, for set_dimension.
Inputs: feature. Returns: count, target, dimensions
get_equationsBRead-onlyIdempotent
Global variables and equations of the active document, with their index.
Inputs: no named parameters. Returns: result
get_feature_treeARead-onlyIdempotent
List of the features of the active document (design tree), with the type of each.
Inputs: no named parameters. Returns: result
get_mass_propertiesARead-onlyIdempotent
Mass, volume, surface area and centre of mass of the active document (part or assembly).
Inputs: no named parameters. Returns: mass_kg, volume_cm3, volume_mm3, surface_area_mm2, +1 more
get_screenshotAIdempotent
PNG image of the active model, to check the result visually. Changes the view orientation (unless view='current') and zooms to fit; the model is not modified.
Inputs: view.
holeA
Drills round holes into a planar face, perpendicular to it.
centers: the hole centres [[x, y, z], ...] in mm, model coordinates, all on the SAME face (the face is found through the first one). size: metric screw size ("M3" ... "M24") with fit: close / normal / loose clearance hole (ISO 273) or tapped = tap drill diameter; or give diameter_mm. depth_mm or through_all=True. style: counterbore / countersink for socket head screws; with a metric size their dimensions are standard (ISO 4762 / ISO 10642, 90 degrees), otherwise give them. thread=True (with a metric size, fit="tapped", style="simple") adds a cosmetic thread to each hole (e.g. M6x1, shown in drawings and the thread callout), over thread_depth_mm or the whole hole.
Inputs: centers (required), fit, size, style, +9 more. Returns: result
insert_componentA
Inserts a part or sub-assembly (a .SLDPRT / .SLDASM file, relative to the projects folder when one is set) into the active assembly, with the component's origin at (x, y, z) mm and no rotation. The file is opened in the background if it is not already open, and its window is closed again afterwards.
Inputs: path (required), x_mm, y_mm, z_mm. Returns: result
insert_model_dimensionsA
Inserts model dimensions marked for drawing across all views in the active 2D drawing.
Inputs: no named parameters. Returns: result
linear_patternA
Repeats features (names from get_feature_tree) in a row along a model axis: count copies in total (original included), spacing_mm apart, towards + (or - with reverse). direction2/count2/spacing2_mm add a second direction for a grid. The first use of an axis adds a hidden reference axis "Axis X (MCP)" (Y, Z) to the tree.
Inputs: count (required), features (required), direction (required), spacing_mm (required), +5 more. Returns: result
list_configurationsARead-onlyIdempotent
Lists all configurations in the active part or assembly document, indicating the active one.
Inputs: no named parameters. Returns: result
list_edgesARead-onlyIdempotent
Edges of the active part (or only those of the faces created by 'feature'), each with its type, its mid-point (point_mm, lying ON the edge: pass it to fillet / chamfer edge_points, select_edge_at_point, circular_pattern axis_edge_point...), length, end points, and centre / diameter of circles and arcs. Use it instead of guessing coordinates.
Inputs: limit, feature, edge_type. Returns: count, edges, total, truncated
list_facesARead-onlyIdempotent
Faces of the active part (or only those created by 'feature'), each with its type, a point lying ON it (point_mm, model coordinates: pass it to select_face_at_point, hole, shell, fillet face_points, create_plane face_point...), area, outward normal of planar faces, and diameter / axis of cylinders (concave=True for holes). Use it instead of guessing coordinates.
Inputs: limit, feature, face_type. Returns: count, faces, total, truncated
list_materialsARead-onlyIdempotent
Materials available in the SolidWorks material databases, filtered by 'search' (part of the name or category, e.g. "6061", "steel", "abs"). Use the exact name with set_material.
Inputs: search. Returns: result
list_open_documentsARead-onlyIdempotent
Documents open in SolidWorks: title, path, type, whether they have unsaved changes, whether they have a window (parts loaded only by an assembly have none) and which one is active.
Inputs: no named parameters. Returns: count, active, documents
loftA
Loft through two or more closed profiles drawn on different planes (see create_plane), in order. guide_sketches: optional guide curves touching every profile. cut=True removes material instead of adding it. Close the sketches first (end_sketch).
Inputs: profile_sketches (required), cut, guide_sketches. Returns: result
measureARead-onlyIdempotent
Measures one entity (area, length, diameter...) or the distance and angle between two, picked by a point lying on each ([x, y, z] in mm, model coordinates). Replaces the current selection.
Inputs: point1 (required), type1, type2, point2. Returns: area_mm2, delta_mm, angle_deg, length_mm, +8 more
mirrorB
Mirrors features (names from get_feature_tree) about a plane: "front", "top", "right", a plane name, or the planar face through face_point ([x, y, z] in mm).
Inputs: features (required), plane, face_point. Returns: result
new_assemblyB
Creates a new empty assembly in SolidWorks using the default or given assembly template.
Inputs: template_path. Returns: result
new_drawingB
Creates a new 2D drawing from the currently active part or assembly document. Generates 3 standard 3rd-angle projection views (Front, Top, Right) and an Isometric view.
Inputs: template_path. Returns: result
new_partB
Creates a new empty part from the default SolidWorks part template.
Inputs: no named parameters. Returns: result
open_documentAIdempotent
Opens a part, assembly or drawing (.SLDPRT / .SLDASM / .SLDDRW) and makes it the active document, to continue work on it. A relative path is relative to the projects folder. If the file is already open it is just brought to the front. read_only=True opens it so that it cannot be saved over. The file itself is not modified. Starts SolidWorks if needed.
Inputs: path (required), read_only. Returns: result
rename_featureA
Renames a feature or sketch of the active part (e.g. "Boss-Extrude1" -> "Base plate"), so the tree is readable and dimensions get meaningful names (D1@Base plate).
Inputs: name (required), new_name (required). Returns: result
revolveA
Revolves the last sketch around the construction line it contains (create it with sketch_line construction=True). cut=True removes material instead of adding it.
Inputs: cut, angle_deg. Returns: result
ribA
Rib from the last sketch: usually an open line between walls of the part, drawn on a plane through the middle of the rib. thickness_mm is the total thickness, centred on the sketch unless one_side=True. direction: parallel = material grows in the sketch plane, normal = perpendicular to it. flip_material flips the side towards which material is added if the rib does not reach the part.
Inputs: thickness_mm (required), one_side, direction, flip_material, +1 more. Returns: result
save_documentADestructiveIdempotent
Saves the active document. With 'path' (e.g. C:\projects\part.SLDPRT, .step, .stl, .pdf...) saves/exports to that file: the format is taken from the extension. When the user has set a projects folder, relative paths are confined to it and missing folders inside it are created. If the target file already exists, overwrite must be True or the save is rejected. new_version=True (no path) saves the document as the next version next to its current file (bracket_v1_base.SLDPRT -> bracket_v2_base.SLDPRT), never overwriting: the open document then becomes the new file and the previous version is kept unchanged. Without path or new_version, the document's own file is overwritten.
Inputs: path, overwrite, new_version. Returns: result
select_edge_at_pointAIdempotent
Selects the edge of the part passing through the point (x, y, z) in mm, model coordinates. append=True adds it to the current selection. Tools such as fillet and chamfer take the points directly, so this is mostly useful to check that a point really lies on an edge.
Inputs: x_mm (required), y_mm (required), z_mm (required), append. Returns: result
select_face_at_pointAIdempotent
Selects the face of the part passing through the point (x, y, z) in mm, model coordinates. Use get_bounding_box to find the coordinates of the outer faces.
Inputs: x_mm (required), y_mm (required), z_mm (required). Returns: result
select_planeAIdempotent
Selects a plane: one of the base planes "front" (XY), "top" (XZ), "right" (YZ), which works with SolidWorks in any language, or a plane by name (e.g. one made by create_plane).
Inputs: plane (required). Returns: result
set_custom_propertyADestructiveIdempotent
Sets a custom property of the active document (created if missing). Replaces the current value. An empty value deletes it.
Inputs: name (required), value (required). Returns: result
set_dimensionADestructiveIdempotent
Changes a dimension (name from get_dimensions, e.g. "D1@Boss-Extrude1") to 'value' (mm, degrees for angles, a plain number for counts such as pattern instances) and rebuilds.
Inputs: name (required), value (required). Returns: result
set_materialADestructiveIdempotent
Assigns a material to the active part (exact name, see list_materials), so that get_mass_properties gives the real mass.
Inputs: name (required). Returns: result
shellA
Hollows the part leaving walls thickness_mm thick. open_face_points: a point on each face to remove ([x, y, z] in mm), e.g. the top of a box; none gives a closed hollow part. outward=True adds the walls outside the current surfaces.
Inputs: thickness_mm (required), outward, open_face_points. Returns: result
sketch_arcC
Draws an arc given centre, start point and end point (mm).
Inputs: end_x_mm (required), end_y_mm (required), start_x_mm (required), start_y_mm (required), +3 more. Returns: result
sketch_circleA
Draws a circle in the open sketch, given centre and DIAMETER (mm).
Inputs: diameter_mm (required), center_x_mm, center_y_mm. Returns: result
sketch_circular_patternA
Repeats sketch entities of the open sketch around a centre (e.g. bolt holes on a flange before one cut). entity_points: [[x, y], ...] one point on each entity; the copies are spread evenly over angle_deg around (center_x_mm, center_y_mm). The entities' centre is computed (for a circle: its centre); give reference_x_mm / reference_y_mm to set it explicitly. rotate=False keeps the copies' orientation. Replaces the selection.
Inputs: count (required), entity_points (required), rotate, angle_deg, +4 more. Returns: result
sketch_ellipseA
Draws an ellipse in the open sketch, given its two diameters (mm). rotation_deg turns the major axis counterclockwise from the sketch X axis.
Inputs: major_diameter_mm (required), minor_diameter_mm (required), center_x_mm, center_y_mm, +1 more. Returns: result
sketch_filletA
Rounds the corner of the open sketch at (x, y) (the point where two entities meet) with the given radius (mm).
Inputs: radius_mm (required), corner_x_mm (required), corner_y_mm (required). Returns: result
sketch_lineA
Draws a line in the open sketch between two points (mm). construction=True creates a construction line (e.g. the axis of a revolve).
Inputs: x1_mm (required), x2_mm (required), y1_mm (required), y2_mm (required), +1 more. Returns: result
sketch_linear_patternA
Repeats sketch entities of the open sketch in a row or a grid (e.g. a row of holes before one cut). entity_points: [[x, y], ...] one point on each entity. count_x copies spacing_x_mm apart along the direction at angle_x_deg from sketch X; count_y / spacing_y_mm / angle_y_deg add a second direction. Replaces the selection.
Inputs: count_x (required), spacing_x_mm (required), entity_points (required), count_y, +3 more. Returns: result
sketch_mirrorA
Mirrors sketch entities of the open sketch about a construction line (sketch_line with construction=True). entity_points: [[x, y], ...] one point on each entity to mirror; mirror_line_point: [x, y] a point on the construction line. Replaces the selection.
Inputs: entity_points (required), mirror_line_point (required). Returns: result
sketch_offsetA
Offsets the chain of connected sketch entities passing through (x, y) by distance_mm. reverse=True offsets to the other side; both_sides=True offsets to both sides.
Inputs: x_mm (required), y_mm (required), distance_mm (required), reverse, +1 more. Returns: result
sketch_pointB
Adds a sketch point at (x, y) mm in the open sketch (e.g. a reference for dimensions or a hole position).
Inputs: x_mm (required), y_mm (required). Returns: result
sketch_polygonA
Draws a regular polygon (e.g. hexagon: sides=6) inscribed in a circle of the given diameter (mm): the vertices lie on the circle (for a hexagon, the diameter is the distance across corners).
Inputs: sides (required), circumscribed_diameter_mm (required), center_x_mm, center_y_mm, +1 more. Returns: result
sketch_rectangleA
Draws a rectangle in the open sketch, given centre and size (mm).
Inputs: width_mm (required), height_mm (required), center_x_mm, center_y_mm. Returns: result
sketch_slotA
Draws a straight slot (two half circles joined by lines) in the open sketch, given the centres of its two ends and its width (mm).
Inputs: x1_mm (required), x2_mm (required), y1_mm (required), y2_mm (required), +1 more. Returns: result
sketch_splineA
Draws a smooth spline through the points [[x, y], ...] of the open sketch (mm, at least 2). Repeat the first point at the end to close it.
Inputs: points (required). Returns: result
sketch_trimADestructive
Trims the sketch entity through (x, y) in the open sketch back to its nearest intersections with other entities: the piece you point at is removed (like Trim to closest). An entity that crosses nothing is deleted entirely. Replaces the selection.
Inputs: x_mm (required), y_mm (required). Returns: result
start_sketchA
Opens a new sketch on the selected plane or face.
Inputs: no named parameters. Returns: result
suppress_featureADestructiveIdempotent
Suppresses (temporarily removes from the model, keeping it in the tree) or, with suppressed=False, restores a feature.
Inputs: name (required), suppressed. Returns: result
sweepA
Sweeps a profile along a path (pipes, springs, handles, grooves).
path_sketch: name of the sketch with the path (open or closed curve). profile_sketch: name of the closed profile sketch, drawn on a plane crossing the start of the path; or leave it empty and give circle_diameter_mm for a round section. cut=True removes material instead of adding it. Close the sketches first (end_sketch).
Inputs: path_sketch (required), cut, profile_sketch, circle_diameter_mm. Returns: result
undoCDestructive
Undoes the last operations in SolidWorks.
Inputs: steps. Returns: result
zoom_to_fitAIdempotent
Fits the view to show the whole model.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 86 tools
Most tools have a recognizable domain (sketching, features, assemblies, drawings), but the large surface creates several overlapping or easily confused pairs: save_document vs export_document vs export_flat_pattern, sketch_fillet vs fillet, sketch_circular_pattern vs circular_pattern, add_sketch_dimension vs set_dimension, and measure vs get_dimensions. Descriptions help clarify boundaries, but an agent still has to choose carefully among many similarly themed operations.
Many tools follow a clear verb_noun pattern (create_plane, list_faces, set_material, delete_feature), but a substantial number are noun-only or adjective-first (extrude, fillet, hole, shell, mirror, measure, undo, base_flange, new_part). The names are readable, but the convention is mixed enough that the set does not feel fully predictable.
Eighty-six tools is far too many for efficient agent selection, even for a complex CAD domain. While many operations are meaningful, the surface is heavy and should be consolidated or grouped into fewer higher-level tools.
Coverage is broad and deep: sketches, features, assemblies, drawings, sheet metal, configurations, materials, equations, custom properties, and exports are all represented. Minor gaps remain in areas like drawing annotation/views and assembly-level lifecycle operations, but core workflows are well covered.
Maintenance
Related MCP Connectors
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Text-to-CAD: build exact STEP or 3MF/STL on the server, each stated requirement measured.
A browser 3D CAD for your AI: it scripts real-size models, uCAD builds them and returns pictures.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to control a running SOLIDWORKS session through its COM API, with tools for sketching, feature creation, assemblies, and visual feedback via screenshots.22Apache 2.0
- FlicenseNot gradedqualityBmaintenanceDrives SolidWorks 2022 on Windows via COM to perform CAD operations like sketching, features, dimensioning, and mass property inspection from AI assistants.2-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to build, measure, verify, and correct parametric SolidWorks parts and assemblies locally via the COM API, supporting operations like sketching, extruding, modeling, dimensioning, material assignment, export, and assembly mating.MIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI assistant to drive an already-running SOLIDWORKS session over its COM API, so it can build sketches, solid features, reference geometry, assemblies, mates, and engineering drawings, then inspect the result through topology listings, mass properties, measurements, and screenshots returned as images.1Apache 2.0