freecad-mcp

Control FreeCAD with Claude AI through natural language!

Create 3D models, add features, and automate CAD workflows using conversational AI.

Watch FreeCAD MCP model a house from a simple text command:

demo-house-modeling.mp4

*"Ask FreeCAD to model a house" - and watch it create walls, roof, windows, and door automatically!*

> 🎉 New! Easy 2-command installation with automatic updates!

Before installation, make sure you have:

• FreeCAD 1.0+ - Download here
• Node.js & npm - Download here
• Claude Code - npm install -g claude-code (recommended)

*Python 3.9+ is included with FreeCAD automatically*

Windows:

python -m pip install --user mcp
npm install -g freecad-mcp-setup@latest
npx freecad-mcp-setup setup

macOS/Linux:

pip install mcp
npm install -g freecad-mcp-setup@latest
npx freecad-mcp-setup setup

That's it! The installer automatically:

• ✅ Cross-platform: Works on macOS, Linux, and Windows
• ✅ Detects your OS and FreeCAD installation
• ✅ Downloads latest FreeCAD MCP from GitHub
• ✅ Installs the AI Copilot workbench to correct location
• ✅ Downloads and registers MCP bridge server
• ✅ Provides clear next steps for testing

To update to the latest version:

Windows:

npm update -g freecad-mcp-setup
npx freecad-mcp-setup setup

macOS/Linux:

npm update -g freecad-mcp-setup
npx freecad-mcp-setup setup

The installer will automatically download and install the latest FreeCAD MCP files!

1. Launch FreeCAD
2. The AI Copilot service starts automatically

In a new terminal/command prompt:

claude