FreeCAD MCP (bonninr)
MCP serverCommunity
A minimal FreeCAD workbench and bridge with two tools: read the scene and run a Python script. By bonninr.
228 starsUpdated 2 years 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
- Not stated in its documentation
- Operating systems
- Windows, macOS, Linux
- Needs a FreeCAD licence
- No
- Transport
- Local (stdio)
- AI clients documented
- Claude Desktop, Cursor
- Licence
- MIT
- Language
- Python
What it can do
- Returns document properties, objects with placement and shape data, sketch geometry and constraints, and camera information.
- Runs arbitrary Python in FreeCAD through a socket server on localhost port 9876.
Limitations
- Only two tools; all modelling goes through the run_script tool.
- Last updated in March 2025.
Install
Clone the repository, place the freecad_mcp directory in your FreeCAD Mod directory, restart FreeCAD and select the FreeCAD MCP workbench.{
"mcpServers": {
"freecad": {
"command": "C:\\ProgramData\\anaconda3\\python.exe",
"args": [
"C:\\Users\\USER\\AppData\\Roaming\\FreeCAD\\Mod\\freecad_mcp\\src\\freecad_bridge.py"
]
}
}
}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.