CadQuery MCP servers and AI agent skills

The CadQuery project publishes its own MCP server in the cadquery-contrib repository, which runs CadQuery scripts and returns renders, measurements and exports. Community work adds a popular Claude Code skill for 3D-printable parts, a model-checking server and a CAD command line that can run CadQuery alongside build123d. Everything works on files, with no CAD program to keep open, on Windows, macOS or Linux. Watch Python versions: CadQuery wheels lag new Python releases.

Includes Open source's official server.
3 MCP servers and 1 agent skill listed.

Open source3 servers · 1 skillChecked 4 Nov 2026

Integrations for CadQuery

Official

MCP serverOfficial (tool developers)

CadQuery MCP Serverby CadQuery

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

LocalWindows, macOS, LinuxCan modify models77· updated 2 weeks ago

Community and commercial servers

MCP serverCommunity

agentcadby James Dillard

A CAD command line and MCP server that runs build123d (or CadQuery) scripts, renders, measures and diffs them.

LocalCan modify models199· updated 1 day ago

MCP serverCommunity

CAD-Query MCP Server (rishigundakaram)by rishigundakaram

A small CadQuery server whose main tool checks a generated model file against criteria you describe.

LocalWindows, macOSRead-only20· updated 1 year ago

Agent skills

SkillCommunity

CAD Skill for Claude Code (parametric-3d-printing)by Flowful.ai (Nicolas Chourrout)

A Claude Code skill that designs 3D-printable CadQuery parts in phases and returns an STL with a preview.

715· updated 12 days ago

Listings are sorted by origin, then by recent activity. GitHub data is refreshed nightly. Nothing here is ranked.

How AI connects to CadQuery

An MCP server or skill can only do what CadQuery lets programs do. CadQuery exposes 2 automation interfaces:

CadQuery Python library (Python): CadQuery models are ordinary Python scripts, so an agent writes code and a runner turns it into solids. That makes results easy to diff and review in version control. The official MCP server accepts Shapes, Workplanes, nested assemblies and several show_object() outputs, and keeps names, colours and locations in assembly STEP exports. One skill notes that CadQuery's OCC kernel has no wheels for Python 3.13 or later, so pin 3.10 to 3.12. Documentation
cq-cli (Command line): cq-cli is the CadQuery project's command-line runner for scripts and exports, and the official MCP server's README points to it for command-line workflows. In October 2026 the cadquery-contrib MCP server gained a companion CLI built on the same execution core, so an agent can use either route. Documentation

What Open source offers

CadQuery is an open-source project, and its developers added an MCP server to the official cadquery-contrib repository in January 2026, published on PyPI as cadquery-mcp by the CadQuery Development Team. It renders PNG or SVG views, reports volume, area and centre of mass, extracts script parameters and exports STEP, STL, 3MF and other formats. There is no hosted service; you run it in your own CadQuery environment.

Checked 4 Nov 2026. Sources: CadQuery MCP Server README (cadquery-contrib), cadquery-mcp on PyPI

What you can do with CadQuery and AI

Write a CadQuery script for a part, run it, and look at isometric and orthographic renders to catch misplaced features before exporting.
Check a model's bounding box, volume and topology counts against the intended design.
Expose a script's parameters so a part family, such as Gridfinity bins, can be regenerated with new dimensions.
Design a 3D-printable part in phases and get an STL, a six-view preview and a 3MF for the slicer.
Export assemblies to STEP with part names, colours and positions kept for other CAD tools.

Taken from the listings' own documentation. Check each listing for exactly what it supports.

Installing

The listings here document setup for Claude Code, Claude Desktop, Cursor and Windsurf. Install steps, copied from each project's own documentation, are on each listing's page. Most CadQuery integrations run on your own computer next to CadQuery, so you need CadQuery installed and licensed on the same machine unless the listing says otherwise.

build123dOpen source3 servers · 1 skill OpenSCADOpen source2 servers · 1 skill FreeCADOpen source8 servers Blender / Bonsai (IFC)Blender Foundation4 servers · 1 skill CalculiXOpen source2 servers · 1 skill MastercamCNC Software1 server

Questions

Is there an official CadQuery MCP server?

Yes. It lives in the CadQuery organisation's cadquery-contrib repository and is published on PyPI as cadquery-mcp by the CadQuery Development Team. It needs CadQuery 2.8 or later.

Does CadQuery need a CAD program running?

No. CadQuery is a Python library, so servers and skills run scripts and write files directly. That also means they work on Windows, macOS and Linux without a CAD licence.

Should I use CadQuery or build123d with an AI agent?

Both are Python code-CAD libraries with different modelling styles. Pick the one your team already reads; listings exist for each, and one CAD command line runs build123d by default with CadQuery as an option.

Why do PNG renders fail in the CadQuery MCP server?

Shaded PNGs need a working VTK and OpenGL back end even off-screen. On headless machines, ask for SVG line drawings instead, which don't need a display.

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

Sources (checked 4 Nov 2026): CadQuery documentation · CadQuery MCP Server README (cadquery-contrib) · cadquery-contrib commit history for mcp-server · CadQuery product page

CadQuery is developed by its own project (Open source). Tresca is independent and not affiliated with or endorsed by the CadQuery project.