freecad-mcp

Overview

FreeCAD MCP is an MCP server that bridges FreeCAD, an open-source parametric 3D modeler, with AI assistants like Claude. It exposes FreeCAD's functionality through a Model Context Protocol interface, allowing users to create complex 3D models and CAD workflows using natural language commands. The server includes a comprehensive set of operations for PartDesign, Part geometry creation, and view control, with clear installation instructions for both Claude Code and Claude Desktop users. The project actively maintains both the MCP server and a user-friendly installer with cross-platform support.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• create_box

  Creates a 3D box object with specified dimensions and fillets

  Try:Create a 50x30x20mm box with 5mm filletsTry:Make a cube with 10mm edge length
• create_cylinder

  Creates a 3D cylinder object with specified radius and height

  Try:Make a cylinder with 25mm radius and 60mm heightTry:Create a tall cylinder with 15mm diameter
• add_fillet

  Adds a fillet to an existing object or feature

  Try:Add a 3mm fillet to Pad001Try:Apply 5mm fillet to all edges
• create_hole

  Creates a counterbore hole at a specified position

  Try:Create a 6mm counterbore hole at position (20,10)Try:Add a 10mm diameter hole at center
• create_pattern

  Creates a linear or circular pattern of features

  Try:Make a linear pattern of 5 copies spaced 30mm apartTry:Create a circular pattern with 8 instances
• create_pad

  Creates a PartDesign pad from a sketch with specified length

  Try:Create a PartDesign pad from Sketch001 with 15mm lengthTry:Add a 20mm pad to Sketch002
• create_mirror

  Creates a mirror of a feature across a specified plane

  Try:Add a mirror of Feature001 across the XZ planeTry:Mirror all selected objects
• take_screenshot

  Takes a screenshot of the current view with specified dimensions

  Try:Take an isometric screenshot at 1200x800Try:Capture a front view
• execute_python

  Executes custom FreeCAD Python scripts for complex operations

  Try:Run a Python script to create a complex shapeTry:Execute FreeCAD API code to modify parameters
• zoom

  Adjusts the zoom level of the current view

  Try:Zoom in on the selected objectTry:Reset zoom to fit all
• select_object

  Selects an object or feature in the FreeCAD document

  Try:Select Sketch001Try:Choose the cylinder created earlier
• document_management

  Manages FreeCAD document operations like saving and closing

  Try:Save the current documentTry:Create a new documentTry:Close the current document

Note: Tool names were inferred from the 'Available Operations' section and example prompts in the README. The README doesn't provide explicit tool names but describes categories of operations with example prompts that suggest MCP tool functionali

Comparable tools

Installation

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

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

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

FAQ

How do I test if FreeCAD MCP is working?

Start FreeCAD, then in Claude type 'Check FreeCAD connection'. You should see confirmation that FreeCAD tools are available.

What versions of FreeCAD are supported?

FreeCAD MCP requires FreeCAD 1.0 or higher. Python 3.9+ is automatically included with FreeCAD.

Can I use FreeCAD MCP with other AI assistants?

Currently, FreeCAD MCP is designed to work with Claude Code and Claude Desktop, which support the MCP protocol.

Compare freecad-mcp with