Onshape

Name: Onshape
Author: gpambrozio

by gpambrozioversion 0.3.0i★ –iRuns on your computer

Registry nameio.github.gpambrozio/onshape

Install

Overview

Description from the maker (original English)

Drive Onshape CAD from an assistant: documents, sketches, solid features, assemblies and exports.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Docs, sheets & office work
You need to fill in: ONSHAPE_ACCESS_KEY, ONSHAPE_SECRET_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: ONSHAPE_ACCESS_KEY, ONSHAPE_SECRET_KEY, ONSHAPE_MCP_OUTPUT_DIR

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "env": {
        "ONSHAPE_ACCESS_KEY": "your-value",
        "ONSHAPE_SECRET_KEY": "your-value",
        "ONSHAPE_MCP_OUTPUT_DIR": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add onshape --env ONSHAPE_ACCESS_KEY=your-value --env ONSHAPE_SECRET_KEY=your-value --env ONSHAPE_MCP_OUTPUT_DIR=your-value -- npx -y @gpambrozio/onshape-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "env": {
        "ONSHAPE_ACCESS_KEY": "your-value",
        "ONSHAPE_SECRET_KEY": "your-value",
        "ONSHAPE_MCP_OUTPUT_DIR": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "onshape": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "env": {
        "ONSHAPE_ACCESS_KEY": "your-value",
        "ONSHAPE_SECRET_KEY": "your-value",
        "ONSHAPE_MCP_OUTPUT_DIR": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

ONSHAPE_ACCESS_KEY secret env
Onshape API access key. Optional: the server signs in through the browser when this is not set.
ONSHAPE_SECRET_KEY secret env
Onshape API secret key, paired with ONSHAPE_ACCESS_KEY.
ONSHAPE_MCP_OUTPUT_DIR env
Directory for exported STL/STEP files and renders. Defaults to the working directory.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account gpambrozio, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Docs, sheets & office worki

More stars than 0% of the other 3541 servers in this category
Published to the registry more recently than 75% of the other 3541 servers in this category
Basic checks equal to or better than 100% of the other 3541 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Onshape safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: ONSHAPE_ACCESS_KEY, ONSHAPE_SECRET_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.3.0) reached the registry 10 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Agent-Native Calendar

by BuilderIO

Agent-Native Google Calendar - manage events, sync, and public booking

Runs in the cloud★ 7,620MITUpdated 2 months ago

Install

Excel MCP Server

by haris-musa

Lets AI create and edit Excel files itself, including formulas, charts and PivotTables, without Excel installed.

Runs on your computer★ 4,276MITUpdated 7 days ago

Install

MCP Server for Excel

by sbroenne

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

Runs on your computer★ 847MITUpdated 4 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Onshape MCP server

Drive Onshape CAD from an AI assistant. 93 tools for documents, part studios, sketching, solid features, assemblies, drawings, measurement and export — and no setup beyond installing it: the first tool call that needs Onshape opens a browser and asks you to connect.

"Make a 60 × 40 × 10 mm bracket with 4 mm mounting holes and 2 mm fillets, then show me a render"

The assistant sketches it, extrudes it, fillets the edges, measures the result, renders it back into the conversation, and exports an STL you can print.

Install

Claude Code

claude mcp add onshape -- npx -y @gpambrozio/onshape-mcp

Claude Desktop — download onshape-mcp- .mcpb from the latest release and double-click it. Nothing else to install.

Cursor, VS Code, Windsurf, Zed and other MCP clients — add the server to the client's MCP config:

"mcpServers": { "onshape": { "command": "npx", "args": ["-y", "@gpambrozio/onshape-mcp"] } } }

The file differs per client: ~/.cursor/mcp.json (Cursor), .vscode/mcp.json (VS Code), ~/.codeium/windsurf/mcp_config.json (Windsurf), ~/.config/zed/settings.json under context_servers (Zed).

Node 20 or newer is required. npx fetches the package on first run.

Signing in

Nothing to configure. The first tool call that needs Onshape starts a sign-in and asks your client to show you the link; clients that support MCP's URL elicitation render it as a prompt, and the rest get the URL in the reply. The page that opens links straight to the key page for your Onshape stack and takes the pasted pair; tick Read, Write and Delete when you create the key so every tool here works. Keys are verified against Onshape, then stored in your OS keychain.

Your credentials never pass through the assistant, the model or this project's authors — the exchange happens between your browser and a server bound to 127.0.0.1 in this process, which is exactly why MCP has URL elicitation.

Other ways in, if you prefer:

`onshape_login` — start the same flow deliberately.
`onshape_set_api_key` — paste a key pair you already have.
OAuth 2.0 — onshape_login with method: "oauth", for an app you registered at the Onshape developer portal with redirect URL http://localhost:8471/oauth/callback. Tokens refresh automatically.
Environment variables — set ONSHAPE_ACCESS_KEY and ONSHAPE_SECRET_KEY for unattended installs, and ONSHAPE_MCP_AUTO_LOGIN=0 to stop the server ever opening a browser.

An existing onshape-cli credential at ~/.onshape/credentials.json is picked up automatically.

onshape_auth_status shows what is in use (redacted); onshape_logout forgets it.

Tools

Area	Tools
Sign-in	`login`, `login_status`, `set_api_key`, `auth_status`, `logout`
Documents	`list_documents`, `search_documents`, `get_document`, `get_document_summary`, `create_document`, `update_document`, `delete_document`, `get_workspaces`, `get_elements`, `find_part_studios`, `list_versions`, `create_version`, `delete_element`
Part studios	`create_part_studio`, `get_features`, `get_feature_specs`, `get_sketch_info`, `get_body_details`, `get_parts`, `mass_properties`, `measure`, `clearance`, `validate_part_studio`, `add_feature`, `update_feature`, `delete_feature`, `rollback`, `eval_featurescript`
Sketching	`sketch_rectangle`, `sketch_circle`, `sketch_line`, `sketch_circle_axis`, `create_sketch`, `sketch_candy_cane_path`
Solids	`extrude`, `hole`, `thicken`, `revolve`, `sweep`, `fillet`, `chamfer`, `shell`, `draft`, `boolean`, `boolean_union`, `mirror`, `linear_pattern`, `circular_pattern`, `offset_plane`
Geometry	`get_edges`, `find_circular_edges`, `find_edges_by_feature`
Variables	`get_variables`, `set_variable`, `get_configuration`, `encode_configuration`
Export	`export_stl`, `export`, `shaded_view`, `get_thumbnail`, `thumbnail_info`
Assemblies	`create_assembly`, `get_assembly`, `insert_instance`, `delete_instance`, `transform_instance`, `get_assembly_features`, `assembly_mate_connector`, `assembly_mate`, `assembly_relation`, `assembly_group`, `assembly_add_feature`, `update_assembly_feature`, `delete_assembly_feature`, `get_mate_values`, `set_mate_values`, `get_bom`, `assembly_mass_properties`
Drawings	`create_drawing`, `get_drawing_views`, `export_drawing`
Feature studios	`create_feature_studio`, `get_feature_studio`, `set_feature_studio`, `get_feature_studio_specs`
Metadata	`get_metadata`, `set_metadata`
Escape hatch	`request`

All names are prefixed onshape_, and every tool returns {"ok": true, "result": …} or {"ok": false, "error": …, "detail": …}.

Worth knowing:

Units are inches and degrees throughout, except STL exports, which are millimetres by default because that is what slicers assume.
Feature tools validate by default. Onshape answers 200 for a feature that fails to regenerate, so each tool re-reads the feature state and fails loudly instead. update_feature also fails when the edit puts another feature into ERROR; errors that were already there before the edit are listed in validation.preexistingErrors instead. Pass validate: false to skip it.
Assemblies: assembly_mate joins Part Studio mate connectors directly ({path: [instance id], connector: "FabC_0.mcPinion"}, as get_assembly lists them), insert_instance takes fixed: true to ground an instance, and assembly_relation couples mates as gear, rack and pinion, screw or linear. set_mate_values drives mates in inches and degrees and fails when Onshape ignores a value, which it does for mates with limits enabled.
Part Studio writes acknowledge applied changes. Creation replies include creationApplied: true; updates include updateApplied: true after the POST completes. Validation errors do not undo the change: inspect the model before retrying. A failed POST does not establish whether the server applied a change. Large replies retain the feature ID and validation outcome inline, with the full response in saved_to. If that file cannot be saved, responseStorageError reports the storage problem without changing the write/validation outcome. validate: false is reported as validationSkipped: true.
Renders come back as images. shaded_view and get_thumbnail return the PNG inline as well as writing it, so the model can see the part.
Big reads spill to disk. Anything over ONSHAPE_MCP_MAX_RESPONSE_BYTES (default 200 kB) is written to a file and summarised, keeping a feature tree from swallowing the context window.
onshape_request reaches any REST endpoint the dedicated tools miss.

Configuration

Every setting is optional.

Variable	Effect
`ONSHAPE_ACCESS_KEY`, `ONSHAPE_SECRET_KEY`	Use this key pair instead of signing in
`ONSHAPE_BASE_URL`	Onshape API host (default `https://cad.onshape.com`)
`ONSHAPE_OAUTH_CLIENT_ID`, `ONSHAPE_OAUTH_CLIENT_SECRET`	OAuth app to sign in with, instead of an API key
`ONSHAPE_MCP_AUTO_LOGIN`	`0` stops tool calls from starting a browser sign-in
`ONSHAPE_MCP_NO_BROWSER`	`1` never launches a browser; the URL is reported instead
`ONSHAPE_MCP_SIGNIN_WAIT_MS`	How long a call waits for sign-in (default 120000)
`ONSHAPE_DOC`, `ONSHAPE_WS`, `ONSHAPE_ELEM`	Default target; these arguments become optional when set
`ONSHAPE_MCP_OUTPUT_DIR`	Where relative export paths land (default: working directory)
`ONSHAPE_MCP_MAX_RESPONSE_BYTES`	Response size before spilling to a file (default 200000)
`ONSHAPE_MCP_CONFIG`	Credential file path (default `~/.onshape-mcp/credentials.json`)
`ONSHAPE_TIMEOUT_MS`	Per-request timeout (default 120000)

Secrets go to the OS keychain (service onshape-mcp) when one is available, and the config file then holds only non-secret metadata. Without a keychain the file holds the secret and is written 0600 inside a 0700 directory.

Onshape account limits

These come from Onshape, not from this server:

Free accounts can only create public documents — pass public: true to onshape_create_document.
Deleting needs a key with delete permission. Without it Onshape answers 403 Invalid API key state; re-create the key at cad.onshape.com/user/developer/apiKeys with Delete ticked.
An instance can only be fixed when it is inserted. There is no public call to fix or unfix one later; insert it again with fixed and delete the old one.
Mate values need API version 10. Older versions accept a write and ignore it; get_mate_values and set_mate_values use v10.
The variable-table endpoint 404s on some accounts. onshape_set_variable and onshape_get_variables fall back to assignVariable features, which work everywhere; result.route / result.source says which path was taken. Setting a name that already has a Variable feature rewrites that feature in place.

Development

npm install

npm run check # type-check npm test # unit tests, no network and no browser npm run build npm run bundle # build the Claude Desktop .mcpb

node scripts/smoke.mjs # live read-only check against your account node scripts/smoke.mjs --write # also builds a throwaway part node scripts/smoke.mjs --assembly # rack and pinion assembly in a scratch document

Layout: src/auth (credential store, keychain, login flows, OAuth, elicitation), src/api (REST wrappers), src/builders (Onshape BTM feature payloads), src/tools (the MCP surface), src/server.ts (registration and the auth gate).

Contributions welcome — see CONTRIBUTING.md. Security reports: SECURITY.md.

Licence

MIT. Portions derived from onshape-cli — see NOTICE.

Not affiliated with, endorsed by, or supported by Onshape or PTC. "Onshape" is a trademark of PTC Inc.

Onshape

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Docs, sheets & office worki

Common questions

Alternatives

Agent-Native Calendar

Excel MCP Server

MCP Server for Excel

README from the maker

Onshape MCP server

Install

Signing in

Tools

Configuration

Onshape account limits

Development

Licence