Skip to content
Tresca

FreeCAD Robust MCP Server

MCP serverCommunity

A paired MCP server and FreeCAD workbench with about 80 tools, macros, undo and headless or Docker modes. By Sean P. Kane.

265 starsUpdated 1 day agoGitHub data from 5 Nov 2026

At a glance

Type
MCP server
Works with
FreeCAD
How it connects
Drives a running copy of the tool
Access
Can modify models
Tool versions
FreeCAD 1.0.2 or newer (1.1.4+ recommended); Python 3.11+
Operating systems
Windows, macOS, Linux
Needs a FreeCAD licence
No
Transport
Local (stdio)
AI clients documented
Claude Code
Licence
Apache-2.0
Language
Python

What it can do

  • Connects to a bridge workbench in FreeCAD over XML-RPC or a JSON socket, or runs FreeCAD headless; an embedded mode imports FreeCAD directly on Linux.
  • Groups tools for execution and debugging, documents, primitives, object management, PartDesign sketches, patterns and edges, views, undo and redo, import and export, macros and the parts library.
  • Requires pairing the server and the bridge under the same operating-system user before Python execution is accepted.
  • Publishes a Docker image for running the server on Docker Desktop.

Limitations

  • Embedded mode crashes on macOS; use XML-RPC or socket mode there.
  • The Docker set-up doesn't work on Docker Engine for Linux, because the bridge listens on loopback only.

Install

pip install freecad-robust-mcp

Source: github.com/spkane/freecad-addon-robust-mcp-server#using-pip

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.