CadQuery MCP Server

MCP serverOfficial (tool developers)

A server in CadQuery's own contrib repository that runs scripts, renders views, measures and exports models. By CadQuery.

77 starsUpdated 2 weeks agoGitHub data from 5 Nov 2026

At a glance

Type: MCP server
Works with: CadQuery
How it connects: Reads and writes files; the tool isn't needed
Access: Can modify models
Tool versions: CadQuery 2.8 or later; MCP Python SDK 1.30 or later
Operating systems: Windows, macOS, Linux
Needs a CadQuery licence: No
Transport: Local (stdio)
AI clients documented: Claude Code, Claude Desktop
Licence: MIT
Language: Python

What it can do

Executes CadQuery code and renders shaded PNGs from eight camera angles or a four-view sheet, or SVG line drawings with hidden lines.
Reports bounding box, volume, surface area, centre of mass and solid, face, edge and vertex counts.
Extracts the customisable parameters from a script.
Exports STEP, STL, SVG, DXF, AMF, 3MF, VRML and BREP; assembly STEP files keep names, colours and locations.

Limitations

PNG rendering needs a working VTK and OpenGL back end; SVG is the fallback where it fails.
Installed from a clone of cadquery-contrib into a CadQuery environment (conda or mamba suggested).

Install

git clone https://github.com/CadQuery/cadquery-contrib.git
cd cadquery-contrib/mcp-server
python -m pip install .

Source: github.com/CadQuery/cadquery-contrib/tree/master/mcp-server#install-from-source

claude mcp add --transport stdio --scope project cadquery -- \
  /absolute/path/to/environment/bin/python -u \
  /absolute/path/to/cadquery-contrib/mcp-server/cadquery_mcp_server.py

Source: github.com/CadQuery/cadquery-contrib/tree/master/mcp-server#claude-code

{
    "mcpServers": {
        "cadquery": {
            "command": "cadquery-mcp"
        }
    }
}

Source: github.com/CadQuery/cadquery-contrib/tree/master/mcp-server#claude-desktop

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.