Skip to main content
Glama
solidworks-mcp

solidworks-mcp

solidworks-mcp

PyPI tests M8ven Trust Score

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 a projects folder 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-server

and 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 doctor
  • Automated 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 doctor checks, 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

get_active_document_info, get_feature_tree, get_bounding_box, get_mass_properties, get_screenshot, measure, check_model

Documents

new_part, open_document, list_open_documents, activate_document, close_document, save_document, export_document

Assemblies

new_assembly, insert_component, add_mate, check_interference

Drawings

new_drawing, insert_model_dimensions

Configurations

list_configurations, activate_configuration, add_configuration

Selection

select_plane, select_face_at_point, select_edge_at_point, list_faces, list_edges

Sketch

start_sketch, end_sketch, sketch_line, sketch_rectangle, sketch_circle, sketch_arc, sketch_polygon, sketch_slot, sketch_ellipse, sketch_spline, sketch_fillet, sketch_offset, sketch_point, sketch_trim, sketch_mirror, sketch_linear_pattern, sketch_circular_pattern, delete_sketch_entity, edit_sketch, convert_entities, convert_point

Sketch constraints

fully_define_sketch, add_sketch_dimension, add_sketch_relation

Features

extrude, cut_extrude, revolve, rib, sweep, loft, create_plane, create_axis, draft

Finishing

fillet, chamfer, shell, hole

Sheet Metal

base_flange, edge_flange, export_flat_pattern

Patterns

linear_pattern, circular_pattern, mirror

Material

list_materials, set_material

Parameters

get_dimensions, set_dimension, suppress_feature, get_equations, add_equation, delete_equation, get_custom_properties, set_custom_property

Editing

edit_feature, rename_feature, undo, delete_feature, zoom_to_fit

Optional

execute_solidworks_macro (off by default, see Security)

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_sketch reports how the sketch axes map onto the model, and convert_point converts 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_faces and list_edges list 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.

  • hole drills 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_axis adds an axis through a cylindrical face, an edge or two planes.

  • Existing parts: open_document opens one, edit_sketch reopens a sketch, edit_feature changes an extrusion's depth or end condition, and save_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):

  1. --config <path> on the command line

  2. the SOLIDWORKS_MCP_CONFIG environment variable

  3. solidworks-mcp.toml in the server's working directory

  4. %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 = true

Enable 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_s if 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\pytest

The 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 sheetmetal

The groups save their files in a temporary folder and close every document they open. The exit code is the number of failed calls.

License

MIT

Available Tools

86 tools
activate_configurationA
Idempotent

Activates an existing configuration by name in the active part or assembly.

Inputs: name (required). Returns: result

activate_documentA
Idempotent

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_interferenceA
Read-onlyIdempotent

Checks the active assembly for volumetric interferences (collisions) between components.

Inputs: no named parameters. Returns: result

check_modelA
Read-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_documentA
Destructive

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_pointA
Read-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_equationB
Destructive

Deletes the equation with that index (see get_equations).

Inputs: index (required). Returns: result

delete_featureB
Destructive

Deletes a feature from the tree by name (see get_feature_tree).

Inputs: name (required). Returns: result

delete_sketch_entityA
Destructive

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_featureA
DestructiveIdempotent

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_documentA
DestructiveIdempotent

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_patternA
DestructiveIdempotent

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_infoA
Read-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_boxA
Read-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_propertiesB
Read-onlyIdempotent

Custom properties of the active document (description, part number, ...), as used in BOMs and title blocks.

Inputs: no named parameters. Returns: result

get_dimensionsA
Read-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_equationsB
Read-onlyIdempotent

Global variables and equations of the active document, with their index.

Inputs: no named parameters. Returns: result

get_feature_treeA
Read-onlyIdempotent

List of the features of the active document (design tree), with the type of each.

Inputs: no named parameters. Returns: result

get_mass_propertiesA
Read-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_screenshotA
Idempotent

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_configurationsA
Read-onlyIdempotent

Lists all configurations in the active part or assembly document, indicating the active one.

Inputs: no named parameters. Returns: result

list_edgesA
Read-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_facesA
Read-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_materialsA
Read-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_documentsA
Read-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

measureA
Read-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_documentA
Idempotent

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_documentA
DestructiveIdempotent

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_pointA
Idempotent

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_pointA
Idempotent

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_planeA
Idempotent

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_propertyA
DestructiveIdempotent

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_dimensionA
DestructiveIdempotent

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_materialA
DestructiveIdempotent

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_trimA
Destructive

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_featureA
DestructiveIdempotent

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

undoC
Destructive

Undoes the last operations in SolidWorks.

Inputs: steps. Returns: result

zoom_to_fitA
Idempotent

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

    B3.3/5.0

    Scored across 86 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to control a running SOLIDWORKS session through its COM API, with tools for sketching, feature creation, assemblies, and visual feedback via screenshots.
      22
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      1
      Apache 2.0