
FreeCAD MCP
Connects Claude directly to FreeCAD through 30+ tools covering parametric modeling, PartDesign operations, CAM toolpath generation, and mesh manipulation. Runs as a bridge between your AI session and live FreeCAD instances, handling document management, sketch constraints, solid operations, and Report View diagnostics. Supports multiple simultaneous FreeCAD processes with instance switching via UUID or labels. Built for daily production use designing parts and generating CNC toolpaths, not just demos. Requires FreeCAD 1.2-dev for CAM features, 1.1.x for everything else. Includes crash instrumentation and socket-based IPC. The author uses it to debug broken external references, generate parametric macros, and iterate on designs through conversation rather than clicking through menus.
- GitHub stars
- 66
- tools
- 3
- transport
- STDIO
- last updated
- Nov 10, 2026
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
list_freecad_instancesLists all live FreeCAD instances and their active document info.
Lists all live FreeCAD instances and their active document info.
No parameter schema in public metadata yet.
select_freecad_instanceSelects a FreeCAD instance by uuid or label for subsequent operations.
Selects a FreeCAD instance by uuid or label for subsequent operations.
No parameter schema in public metadata yet.
spawn_freecad_instanceSpawns a new FreeCAD instance (GUI or headless) with an optional label and binary path.
Spawns a new FreeCAD instance (GUI or headless) with an optional label and binary path.
No parameter schema in public metadata yet.
Sponsors
Readme
freecad-mcp
What This Does
This is a bridge between your AI agent and FreeCAD — a thinking partner for parametric design, CNC toolpath generation, and mesh work. You bring the design intent and the domain judgment; the agent handles the FreeCAD mechanics. Together: moving faster, co-designing things that would take hours to build by hand, untangling the cryptic error messages that FreeCAD is so good at generating, and hunting down the subtle, knotty modeling problems that are nearly impossible to find alone. Built for personal daily use — designing parts, generating toolpaths, printing and cutting them — not a demo. See TOOLS.md for the full tool reference.
What You Can Work On Together
Details
- Repository
- github.com/blwfish/freecad-mcp
- Category
- Design & Creative
- Package
ghcr.io/blwfish/freecad-mcp:latest- Transport
- STDIO
- Registry
- MCP registry, active