# Onshape

> Onshape is an MCP server for design and media. Drive Onshape CAD from an assistant: sketches, solids, assemblies, drawings and exports. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/gpambrozio/onshape-mcp
- **MCP Registry name:** io.github.gpambrozio/onshape
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [manufacturing](https://ai-powered.com/categories/manufacturing)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add onshape --env ONSHAPE_ACCESS_KEY='<ONSHAPE_ACCESS_KEY>' --env ONSHAPE_SECRET_KEY='<ONSHAPE_SECRET_KEY>' -- npx -y @gpambrozio/onshape-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "env": {
        "ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
        "ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "env": {
        "ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
        "ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "env": {
        "ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
        "ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "env": {
        "ONSHAPE_ACCESS_KEY": "<ONSHAPE_ACCESS_KEY>",
        "ONSHAPE_SECRET_KEY": "<ONSHAPE_SECRET_KEY>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [SeedanceAI MCP](https://ai-powered.com/mcp/seedanceai-mcp): SeedanceAI MCP is an open-source MCP server for design and media.
- [Pixabay](https://ai-powered.com/mcp/pixabay): Pixabay is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/onshape
