Skip to content
MCP server

Onshape

Drive Onshape CAD from an assistant: sketches, solids, assemblies, drawings and exports

Runs locallyStatus and history
Install
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-mcp

Add 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.

How AIPoweredBot checks servers