Log inSubmit server
Onshape logo

Onshape

Drive Onshape documents, Part Studios, assemblies, drawings, measurements, and exports through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Onshape

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 93 tools correctly ().

Overview

The onshape MCP server connects AI assistants to Onshape CAD for document management, sketching, feature-based modeling, assemblies, drawings, measurement, rendering, and export. It runs as a local stdio MCP process, authenticates with an Onshape API key or OAuth, and stores credentials through the OS keychain when available. Use it when an agent needs to inspect or modify CAD models rather than only generate design instructions. Validation, version snapshots, image renders, and file-backed large responses help manage model edits and detailed CAD results.

Use cases

  • Create and modify parametric Part Studio models
  • Inspect unfamiliar Onshape documents and collect element IDs
  • Build assemblies from Part Studio instances
  • Measure, validate, render, and export CAD designs
  • Create and export Onshape drawings

Key features

  • Browser, OAuth, and direct API-key authentication
  • Document, workspace, version, and element management
  • Sketching and feature-based solid modeling
  • Assembly mates, relations, and BOM inspection
  • Model measurement, validation, rendering, and export
  • REST escape hatch for uncovered Onshape endpoints

Tools93

What Onshape lets your agent do. Expand a tool for its parameters.

Verified live~21.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

8/8 checks healthy over the last 31d

What it can do

From the 93 tools this server returned when we ran it; 93 declare their own safety hints.

Runs commands · 2Can delete or modify data · 8Handles credentials · 4Makes network requests · 2Read-only tools · 83
Tool definitions changed on 2026-11-11. Review them if you approved this server earlier.
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age51 days
Maintainers1

Observed 2026-11-11 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @gpambrozio/onshape-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars7Stargazers on the source repository.
npm downloads694Package downloads in the last 30 days.
Last commit12d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed93Callable tools this server registers over MCP.
Directory activity10 viewsConfig copies, upvotes, and views on AllMCPs.

How Onshape works

What onshape does

onshape exposes Onshape CAD operations as MCP tools. The coverage spans the document hierarchy, including documents, workspaces, elements, Part Studios, Feature Studios, assemblies, and drawings. Agents can create, rename, inspect, version, and delete document content, then work with sketches, solid features, variables, parts, bodies, faces, and edges.

Modeling tools support common sketch and solid operations such as rectangles, circles, lines, extrudes, holes, revolves, sweeps, fillets, chamfers, shells, drafts, booleans, mirrors, and patterns. Dedicated inspection tools return feature trees, sketch geometry, body topology, parts, mass properties, bounding boxes, volume, and validation results. Assemblies can be built from Part Studio instances and configured with mate connectors, mate values, relations, and groups. Drawings can be created, inspected, and exported.

How it works

The package runs as an MCP server and prefixes its tools with onshape_. Responses use an ok status with either a result or error details. The onshape_request tool provides access to Onshape REST endpoints that are not covered by a dedicated operation.

The first operation that needs Onshape can start browser-based sign-in. API-key login opens a local page for entering a key pair, while OAuth uses an authorization-code flow for an app registered with Onshape. Credentials are checked against Onshape before storage. Login status can be polled while the browser flow is in progress, and existing credentials from onshape-cli can be reused.

Feature writes validate regeneration by default instead of relying only on an HTTP success response. Model edits can be checked with measurement or Part Studio validation tools, and a document version can be created before restructuring a design. Image-producing tools return shaded views and thumbnails inline. Large responses are written to disk after exceeding the configured response-size threshold.

Setup and configuration

Node.js 20 or newer is required. Claude Code can register the server with npx -y @gpambrozio/onshape-mcp; Claude Desktop can use the .mcpb package from the latest GitHub release. Other clients use an MCP configuration entry that runs the same npx command.

No environment variables are required for normal interactive use. Unattended setups can provide ONSHAPE_ACCESS_KEY and ONSHAPE_SECRET_KEY, and ONSHAPE_MCP_AUTO_LOGIN=0 prevents automatic browser login. OAuth can use ONSHAPE_OAUTH_CLIENT_ID and ONSHAPE_OAUTH_CLIENT_SECRET. Other settings select the API host, default document/workspace/element, export directory, credential path, response-size limit, sign-in wait, browser behavior, and request timeout.

Tools and capabilities

  • Manage documents, workspaces, elements, versions, Part Studios, Feature Studios, and metadata.
  • Create and inspect sketches, feature trees, bodies, parts, edges, and solid geometry.
  • Add, update, delete, and validate features, including hand-written BTM payloads.
  • Build assemblies with instances, mate connectors, mates, relations, and BOM data.
  • Measure models, calculate mass properties, render views, and export STL or drawings.
  • Authenticate with browser login, OAuth, direct API keys, or inherited onshape-cli credentials.

Limitations and notes

Onshape uses inches and degrees throughout these tools; STL exports default to millimetres. Free Onshape accounts can create only public documents, so document creation must use public=true for those accounts. Deleting requires an API key with delete permission.

A feature validation error does not undo a completed change. Inspect the model before retrying, especially after a failed request whose application status is uncertain. Deleting or changing a feature can cause later features to fail regeneration. Creating a version before major restructuring is the available way to return to the prior workspace state.

Credentials supplied through environment variables or an existing onshape-cli installation are not removed by onshape_logout. When no OS keychain is available, the credential file stores the secret with restrictive file and directory permissions.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Onshape

onshape is an MCP server that connects AI assistants to Onshape CAD. Its main tools manage documents and workspaces, create sketches and solid features, inspect geometry, build assemblies and drawings, measure models, render views, and export CAD results such as STL files.

Install it by running `npx -y @gpambrozio/onshape-mcp` from your MCP client configuration. Claude Code has a dedicated `claude mcp add` command, while Claude Desktop can use the `.mcpb` file from the latest GitHub release. Node.js 20 or newer is required.

Authenticate through the browser-based login flow, `onshape_set_api_key`, OAuth, or the `ONSHAPE_ACCESS_KEY` and `ONSHAPE_SECRET_KEY` environment variables. Interactive login verifies the credential with Onshape and stores it in the OS keychain when available.

Yes, onshape works with Cursor through its MCP configuration. Add a server entry that runs `npx -y @gpambrozio/onshape-mcp` in `~/.cursor/mcp.json`, then authenticate when a tool first needs access to Onshape.

The tools use inches and degrees for model operations, while STL exports use millimetres by default. This matches the server's documented handling of dimensions and slicer-oriented STL output.

Related MCP servers

All in Architecture & Design All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOnshape AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/onshape?style=directory)](https://allmcps.com/mcp/onshape)
HTML Embed
<a href="https://allmcps.com/mcp/onshape"><img src="https://allmcps.com/api/badge/onshape?style=directory" alt="Onshape on AllMCPs" /></a>