FreeCAD MCP - AI-Powered CAD

Control FreeCAD with Claude AI through natural language!

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

🎥 See It In Action

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!

📋 Requirements

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

⚡ Super Easy Install

🚀 Quick Install

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

📦 Updating

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!

🚀 How to Use

Step 1: Start FreeCAD

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

Step 2: Open Claude

In a new terminal/command prompt:

claude

Step 3: Verify Connection

Ask Claude:

Check FreeCAD connection

You should see confirmation that FreeCAD tools are available.

Step 4: Start Creating!

Just ask Claude to design anything - watch the demo video above to see it model a house!

🖥️ Using Claude Desktop?

The installer works with Claude Code by default. For Claude Desktop users, after running the installer, you'll need to manually configure:

Add to your Claude Desktop config:

macOS/Linux:

{
  "mcpServers": {
    "freecad": {
      "command": "python3",
      "args": ["/Users/yourusername/.freecad-mcp/working_bridge.py"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "freecad": {
      "command": "python3",
      "args": ["C:\\Users\\yourusername\\.freecad-mcp\\working_bridge.py"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

🔧 Manual Installation (Developers)

For developers who prefer full control:

# Clone the repository
git clone https://github.com/contextform/freecad-mcp.git
cd freecad-mcp

# Install dependencies
python3 -m pip install mcp

# Install FreeCAD workbench (choose your OS):
# macOS:
cp -r AICopilot ~/Library/Application\ Support/FreeCAD/Mod/

# Linux:
# cp -r AICopilot ~/.local/share/FreeCAD/Mod/

# Windows:
# cp -r AICopilot %APPDATA%\FreeCAD\Mod\