freecad

FreeCAD MCP provides an AI-assisted bridge between Claude and FreeCAD. By starting the bridge and connecting via Claude, you can issue natural language commands to create and modify CAD models, apply features, and automate workflows inside FreeCAD. The system exposes a set of PartDesign, Part, View Control, and Python execution operations that allow you to build parametric parts, perform transformations, capture screenshots, and run custom FreeCAD scripts through Claude AI. Use the demo to see how a simple text request can generate a house model with walls, a roof, windows, and a door, then iterate on the design with additional commands.

To use it, install the MCP setup, start FreeCAD, open Claude (via Claude Code or Claude Desktop), and verify the connection to the FreeCAD MCP bridge. Once connected, you can ask Claude to list available tools, create basic shapes, apply fillets or patterns, and run more advanced operations like mirroring parts or generating isometric views. For Claude Desktop users, you may need to add a small client configuration that points Claude to the working_bridge.py script so Claude can communicate with FreeCAD through the MCP bridge.

Prerequisites:

• FreeCAD 1.0+ installed
• Node.js and npm installed
• Python 3.9+ (often included with FreeCAD)
• Claude Code (optional, for Claude integration)

Installation steps (quick install):

# Install the MCP framework for Python
pip install mcp

# Install the FreeCAD MCP setup tool (Node.js-based helper)
npm install -g freecad-mcp-setup@latest

Register and set up the MCP bridge:

npx freecad-mcp-setup setup

Notes:

• The installer will detect your OS and FreeCAD installation, download the necessary MCP bridge, and register the MCP server so Claude can communicate with FreeCAD.
• If you are using Claude Desktop, you may need to add a small client entry pointing to the bridge script as shown in the references below.

Manual verification (optional):

# Check available MCP commands
claude mcp list

Tips and common issues:

• Ensure FreeCAD is installed and the path is discoverable by the bridge. If FreeCAD isn’t found, re-run the installer or verify your FreeCAD installation path.
• For Claude Desktop users, update claude_desktop_config.json to include the freecad server, pointing to the Python bridge script (working_bridge.py).
• If you encounter compatibility issues, re-run: freecad-mcp setup or claude mcp add freecad python3 <path-to-working_bridge.py>
• The available operations include PartDesign and Part primitives, transformations, view controls (screenshots, zoom), and Python execution for custom scripts.
• When using the CLI, you can ask for listing available tools, creating shapes (boxes, cylinders), applying fillets, creating patterns, or exporting views.