FreeCAD MCP

License: MIT FreeCAD Python

A Model Context Protocol (MCP) server that enables AI assistants (Claude Desktop, opencode, etc.) to control FreeCAD — a parametric 3D CAD modeler.

Create 3D parts, run FEM analysis, generate drawings, and more — all through natural language.

✨ Features

3D Modeling: Create boxes, cylinders, spheres, cones, torus, and more
FEM Analysis: Run CalculiX solver for stress/displacement analysis
Screenshot Capture: Get view screenshots from any angle
Parts Library: Insert pre-made parts from FreeCAD library
Custom Python: Execute arbitrary Python code in FreeCAD
Remote Connections: Control FreeCAD from another machine**

Sample Model with Opencode + Qwen 3.6 35B A3B + Llama.cpp + Freecad MCP + Mattpocock skills(Freecad Crafted) -> Yes 3d modelling via AI is possible.!.**

STILL ONLY SMALL 3D PARTS ITS ABLE TO MAKE WITH 35B PARAMETER MODEL, BUT FABLE 5 EXECUTES COMPLEX CAD MODELS EVEN HUMANOID ROBOTS !.

📦 Installation

1. Install FreeCAD

# Ubuntu/Debian (via Flatpak - recommended)
flatpak install flathub org.freecad.FreeCAD -y

# Or download from https://freecad.org/download/

2. Install FreeCAD Addon

git clone https://github.com/GadatheGod/freecad-mcp-pro
cd freecad-mcp-pro

# Copy addon to FreeCAD Mod directory
cp -r addon/FreeCADMCP ~/.var/app/org.freecad.FreeCAD/config/FreeCAD/Mod/

# Restart FreeCAD

3. Install MCP Server

# Using uv (recommended)
uv sync

# Or using pip
pip install -e .

4. Configure Claude Desktop

Edit ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "freecad": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/freecad-mcp-pro",
        "run",
        "freecad-mcp-pro"
      ]
    }
  }
}

🚀 Usage

Start FreeCAD RPC Server

Open FreeCAD
Switch to MCP Addon workbench
Click Start RPC Server in the toolbar

Available Tools

Tool	Description
`create_document`	Create a new FreeCAD document
`create_object`	Create 3D objects (boxes, cylinders, etc.)
`edit_object`	Modify object properties
`delete_object`	Delete an object
`execute_code`	Run Python code in FreeCAD
`get_view`	Get screenshots from any view
`get_objects`	List all objects in a document
`get_object`	Get details of a specific object
`run_fem_analysis`	Run FEM stress analysis
`insert_part_from_library`	Insert parts from FreeCAD library

Example: Create a Box

{
  "doc_name": "MyPart",
  "obj_name": "BaseBox",
  "obj_type": "Part::Box",
  "obj_properties": {
    "Length": 50,
    "Width": 30,
    "Height": 20,
    "ViewObject": {"ShapeColor": [0.8, 0.2, 0.2, 1.0]}
  }
}

🛠️ Skills

This repository includes skills for working with FreeCAD via opencode:

Core Skills

freecad - General FreeCAD MCP usage and workflows
freecad-objects - Quick reference for Part::Box, Part::Cylinder, etc.

Matt Pocock Skills (FreeCAD-tailored)

f-grill-with-docs - Interview to sharpen FreeCAD design plans, creates ADRs
f-to-spec - Convert conversation into FreeCAD design spec
f-to-tickets - Break design into FreeCAD implementation tickets
f-implement - Create FreeCAD geometry/analysis based on tickets
f-code-review - Review FreeCAD changes against standards and spec

📚 Documentation

FreeCAD Wiki: 2,632 markdown files in docs/freecad/
Source: Converted from FreeCAD-documentation
Addon Docs: See addon/FreeCADMCP/ for RPC server details

🏗️ Architecture

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  AI Client  │────▶│  MCP Server  │────▶│  FreeCAD    │
│ (Claude,    │     │ (freecad-mcp-pro)│     │  (RPC)      │
│  opencode)  │     │              │     │             │
└─────────────┘     └──────────────┘     └─────────────┘

📄 License

MIT License. See LICENSE for details.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.