freecad-mcp (blwfish)
MCP serverCommunity
A FreeCAD bridge for design, debugging, mesh work and CAM toolpaths, able to talk to several FreeCAD windows. By blwfish.
63 starsUpdated 4 days agoGitHub data from 5 Nov 2026
At a glance
- Type
- MCP server
- Works with
- FreeCAD
- How it connects
- Drives a running copy of the tool
- Access
- Can modify models
- Tool versions
- FreeCAD 1.1.x for all tools except CAM; CAM needs a current FreeCAD weekly build
- Operating systems
- Windows, macOS, Linux
- Needs a FreeCAD licence
- No
- Transport
- Local (stdio)
- AI clients documented
- Claude Code
- Licence
- LGPL-2.1
- Language
- Python
What it can do
- Reads FreeCAD's Report View and sketch constraints to help diagnose failed features.
- Checks geometry, wall thickness and collisions, imports STL meshes and exports STEP.
- Generates CNC toolpaths and G-code through FreeCAD's CAM workbench.
- Discovers and switches between several running FreeCAD instances, GUI or headless.
Limitations
- CAM tools need a FreeCAD weekly development build because the Path API changed after 1.1.
- Developed on macOS; the author says Windows and Linux are less tested.
Install
Tell your AI agent to go to https://github.com/blwfish/freecad-mcp, read AGENT-INSTALL.md and follow the instructions to install and configure the FreeCAD MCP server on your machine.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.