Onshape MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Onshape MCP ServerGenerate a spur gear with 30 teeth"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Onshape MCP Server
Enhanced Model Context Protocol (MCP) server for programmatic CAD modeling with Onshape.
✨ Features
🔍 Document Discovery - Search and list projects, find Part Studios
📐 Parametric Sketching - Create sketches with rectangles, circles, lines
⚙️ Feature Management - Extrudes, fillets, chamfers, feature trees
🔩 Mechanical Components - Create gears with customizable parameters
🎯 Edge Query & Discovery - Find edges by radius, type, or feature
📊 Variable Tables - Read/write parametric design variables
🤖 Full Automation - Build complete CAD workflows
Related MCP server: solidworks-mcp
🚀 Quick Start
Prerequisites
Python 3.10+
Onshape account with API access
Setup
git clone https://github.com/clarsbyte/onshape-mcp.git
cd onshape-mcp
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -e .Get API Keys
Go to Onshape Developer Portal
Create API key → copy Access Key and Secret Key
Configure Gemini CLI
Add to your Gemini CLI configuration file (typically ~/.config/gemini-cli/settings.json):
{
"mcpServers": {
"onshape": {
"command": "/absolute/path/to/onshape-mcp/venv/bin/python",
"args": ["-m", "onshape_mcp.server"],
"env": {
"ONSHAPE_ACCESS_KEY": "your_access_key",
"ONSHAPE_SECRET_KEY": "your_secret_key"
}
}
}
}Usage
onshape-mcp # Run serverAsk Gemini CLI: "Create a mechanical part with variable dimensions""
This server cannot be deployed
Maintenance
Related MCP Connectors
- OwlCADOAuthcom.owlcad
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Run 3D CAD operations, pipelines, parametric models and STEP conversions on CAD Cloud with a key
Agent-first CAD: editable .kcad.ts source, deterministic review, OpenCASCADE kernel.
Bitbybit 3D parametric CAD API, version-exact, for coding agents: search, describe, examples, guide
Related MCP Servers
- FlicenseBqualityAmaintenanceEnables programmatic CAD modeling with Onshape's REST API, offering 45 tools for parametric sketches, feature management, assemblies, analysis, variables, and exports.48144-
- AlicenseNot gradedqualityCmaintenanceEnables building and modifying parametric solid models in a local SOLIDWORKS installation via the COM API.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude Code to drive OnShape CAD through the REST API for parametric modeling, FeatureScript queries, and STL export/verification.MIT
- AlicenseBqualityCmaintenanceEnables OpenAI Codex to drive real Onshape parametric CAD via 69 tools for documents, sketches, features, assemblies, parametric updates, FeatureScript, vision, and export.69MIT