Onshape
Drive Onshape CAD from an assistant: sketches, solids, assemblies, drawings and exports
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- today
Similar MCP servers
About Onshape
Onshape is an MCP server for design and media. It runs locally on your machine and is started by your AI client.
With 93 tools, an assistant can build a part from a plain request such as a 60 x 40 x 10 mm bracket with mounting holes and fillets. It sketches, extrudes, fillets, measures the result, shows a render back in the conversation and exports an STL for printing. Assemblies support mates, gear, rack and pinion and screw relations, bills of materials and mass properties, and it can create drawings, feature studios and metadata.
Feature tools check the result by default, because Onshape answers 200 even for a feature that fails to regenerate; a failed regeneration is reported as an error, and an escape-hatch request tool reaches any REST endpoint the dedicated tools miss. Units are inches and degrees, except STL exports, which default to millimetres. Large replies over 200 kB are written to a file and summarised so a feature tree does not fill the context window.
It runs locally over stdio (Node 20 or newer). The first call that needs Onshape opens a browser to connect an API key pair, stored in the OS keychain; OAuth 2.0 and environment variables are alternatives. Credentials never pass through the model.
Install
Run in a terminal
claude mcp add onshape --env ONSHAPE_ACCESS_KEY='<ONSHAPE_ACCESS_KEY>' --env ONSHAPE_SECRET_KEY='<ONSHAPE_SECRET_KEY>' -- npx -y @gpambrozio/onshape-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"onshape": {
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
],
"env": {
"ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
"ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"onshape": {
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
],
"env": {
"ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
"ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"onshape": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
],
"env": {
"ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
"ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"onshape": {
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
],
"env": {
"ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
"ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"onshape": {
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
],
"env": {
"ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
"ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ONSHAPE_ACCESS_KEYOnshape API access key. Optional: the server signs in through the browser when this is not set.ONSHAPE_SECRET_KEYOnshape API secret key, paired with ONSHAPE_ACCESS_KEY.ONSHAPE_MCP_OUTPUT_DIRDirectory for exported STL/STEP files and renders. Defaults to the working directory.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- onshape_login
- Start the browser sign-in flow.
- onshape_list_documents
- List Onshape documents.
- onshape_create_document
- Create a document.
- onshape_create_part_studio
- Create a part studio.
- onshape_sketch_rectangle
- Sketch a rectangle.
- onshape_extrude
- Extrude a sketch into a solid.
- onshape_fillet
- Fillet edges.
- onshape_hole
- Add holes.
- onshape_create_assembly
- Create an assembly.
- onshape_assembly_mate
- Join mate connectors in an assembly.
- onshape_get_bom
- Get an assembly bill of materials.
- onshape_export_stl
- Export an STL file.
- onshape_shaded_view
- Return a shaded render.
- onshape_mass_properties
- Get mass properties.
- onshape_request
- Call any Onshape REST endpoint.
What it does
- 93 CAD tools
- Covers documents, part studios, sketching, solids, assemblies, drawings and export.
- Validated feature edits
- Failed regenerations are reported instead of passing silently.
- Inline renders
- Shaded views and thumbnails return as images the model can see.
- Assembly mates
- Mates, relations, instances and bill of materials.
- Browser sign-in
- Keys are collected in the browser and kept in the OS keychain.
- Spill-to-disk replies
- Big responses are saved to a file and summarised.
Good for
- Generate a printable bracket from a text description
- Edit parameters through variables and configurations
- Assemble parts and read the bill of materials
- Export STL, STEP or drawings from existing documents
- Inspect mass properties and clearance between parts
Onshape FAQ
How do I sign in?
The first tool that needs Onshape opens a browser to take an API key pair; OAuth 2.0 and environment variables also work.
What units does it use?
Inches and degrees, except STL exports, which default to millimetres.
What do I need to run it?
Node 20 or newer; npx fetches the package, or Claude Desktop can use the .mcpb bundle.
Can it write and delete?
Yes, if the API key has Write and Delete scopes ticked.
How do I add Onshape to Claude Code?
Run this command in your terminal: claude mcp add onshape --env ONSHAPE_ACCESS_KEY='<ONSHAPE_ACCESS_KEY>' --env ONSHAPE_SECRET_KEY='<ONSHAPE_SECRET_KEY>' -- npx -y @gpambrozio/onshape-mcp
What are the best alternatives to Onshape?
The closest alternatives to Onshape are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



