---
name: freecad-mcp
description: FreeCAD 3D mechanical and parametric modeling MCP service. Connects AI models to the open-source FreeCAD CAD application for natural-language driven solid modeling, feature operations, and headless batch export/conversion.
---

# FreeCAD MCP - 3D Parametric Modeling and Automation

- **Project homepage**: https://github.com/contextform/freecad-mcp

## Overview

`freecad-mcp` connects AI models to the open-source FreeCAD 3D mechanical design application. It lets a language model act as a copilot through the FreeCAD Python API to automate part design, feature stacking, and file format conversion.

### Supported Software

- FreeCAD (open-source 3D CAD)

### Core Capabilities

- **Basic solid modeling**: create boxes, cylinders, spheres, and other primitives
- **Feature operations**: boolean operations, Pad, Fillet, and Chamfer
- **Automation pipeline**: batch macros or conversions can run headlessly without opening the GUI
- **Interactive refinement**: keep adjusting the model through text prompts until it matches the desired result

## Requirements

- Windows, macOS, or Linux
- FreeCAD installed with the Python environment configured correctly
- Python dependencies such as `mcp` installed

## Notes

- The project is still in an early, fast-iterating stage, so complex sketch extrusions may occasionally hit topological naming issues. It is best suited to clearly structured parts.
- Check compatibility carefully when upgrading the Python SDK.

## Details

For install steps and runtime configuration, see the local repository's `README.md`.

