Skip to content
Tresca

FreeCAD MCP servers and AI agent skills

FreeCAD has a wide choice of community MCP servers, including neka-nat's freecad-mcp, the most starred on GitHub. Most pair a FreeCAD addon or workbench, which opens a local RPC or socket listener, with an external server your AI client starts; a few can also run FreeCAD headless through freecadcmd. They work on Windows, macOS and Linux with no licence cost. Check each project's FreeCAD version: most target 1.0 or 1.1, and some CAM tools need a development build.

  • No official Open source server yet.
  • 8 MCP servers listed.
Open source8 serversChecked 4 Nov 2026

Integrations for FreeCAD

Community and commercial servers

MCP serverCommunity

FreeCAD Robust MCP Serverby Sean P. Kane

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

LocalWindows, macOS, LinuxCan modify models265· updated 1 day ago
MCP serverCommunity

freecad-mcp (blwfish)by blwfish

A FreeCAD bridge for design, debugging, mesh work and CAM toolpaths, able to talk to several FreeCAD windows.

LocalWindows, macOS, LinuxCan modify models63· updated 4 days ago
MCP serverCommunity

FreeCAD MCP (neka-nat)by neka-nat

A FreeCAD addon plus uvx server that edits documents, runs Python, imports library parts and runs CalculiX FEM.

LocalWindows, macOS, LinuxCan modify models3.2k· updated 12 days ago
PluginCommunity

FreeCAD AIby ghbalf

An in-app chat workbench for FreeCAD with 50 tools and skills, which can also serve those tools over MCP.

LocalWindows, macOS, LinuxCan modify models615· updated 3 weeks ago
MCP serverCommunity

FEP Agent Hubby S2mon123

Three local MCP servers for a FreeCAD to Elmer FEM to ParaView chain, with workspace limits and physics checks on every result.

LocalWindowsCan modify models5· updated 3 months ago
MCP serverCommunity

FreeCAD MCP Plugin (ATOI-Ming)by ATOI-Ming

A FreeCAD workbench and control panel that lets an agent create, update and run .FCMacro files and set views.

LocalWindows, macOS, LinuxCan modify models101· updated 5 months ago
MCP serverCommunity

FreeCAD MCP (contextform)by contextform

An npm installer that adds an AI Copilot workbench and MCP bridge to FreeCAD for PartDesign, Part and views.

LocalWindows, macOS, LinuxCan modify models139· updated 1 year ago
MCP serverCommunity

FreeCAD MCP (bonninr)by bonninr

A minimal FreeCAD workbench and bridge with two tools: read the scene and run a Python script.

LocalWindows, macOS, LinuxCan modify models228· updated 2 years ago

Listings are sorted by origin, then by recent activity. GitHub data is refreshed nightly. Nothing here is ranked.

How AI connects to FreeCAD

An MCP server or skill can only do what FreeCAD lets programs do. FreeCAD exposes 2 automation interfaces:

  • FreeCAD Python API (Python): Almost everything in FreeCAD is reachable from its bundled Python, through the FreeCAD (App) and FreeCADGui modules, and the MCP servers here mostly forward Python into a running session. Mind the two interpreters: the addon runs inside FreeCAD's own Python (3.11 on some builds), while the external MCP server often needs 3.12 or later, so don't install server packages into FreeCAD's Python. Macros (.FCMacro files) are the same Python saved for reuse. Documentation
  • Headless FreeCAD (freecadcmd) (Command line): freecadcmd runs FreeCAD without its GUI, which suits batch exports and heavy OpenCascade operations such as sweeps, lofts and big booleans that can crash or freeze the interface. One listed server sends such scripts to a separate freecadcmd process so a crash doesn't cost you open documents; another can import FreeCAD into its own process on Linux only. Documentation

What Open source offers

FreeCAD is developed by an open-source community rather than a software vendor, and the project has announced no AI assistant or MCP server of its own. Its blog, checked on 4 November 2026, covered the FreeCAD 26.3 release candidates and grant-funded work, with no AI integration. All FreeCAD MCP servers and AI workbenches listed here are independent community projects distributed as addons.

Checked 4 Nov 2026. Sources: FreeCAD news blog

What you can do with FreeCAD and AI

  • Model a part such as a flange or bracket from a description, creating and editing objects in an open document and returning a screenshot after each change.
  • Run a CalculiX FEM analysis on an existing FreeCAD analysis container and report peak von Mises stress and displacement.
  • Send long OpenCascade operations, such as threaded sweeps or large booleans, to a headless freecadcmd process, then reload the saved file in the GUI.
  • Insert standard parts from the FreeCAD parts library, then export STEP or STL.
  • Diagnose a failed Pad or a broken external link by reading the Report View and sketch constraints.
  • Generate CNC toolpaths and G-code through the CAM workbench (with a current development build).

Taken from the listings' own documentation. Check each listing for exactly what it supports.

Installing

The listings here document setup for Claude Code, Claude Desktop, Codex and Cursor. Install steps, copied from each project's own documentation, are on each listing's page. Most FreeCAD integrations run on your own computer next to FreeCAD, so you need FreeCAD installed and licensed on the same machine unless the listing says otherwise.

Questions

Is there an official FreeCAD MCP server?

No. FreeCAD is community-developed and the project hasn't published one. The servers here are independent addons; neka-nat's freecad-mcp is the most widely starred on GitHub.

How does Claude connect to FreeCAD?

Most servers have two parts. You copy an addon into FreeCAD's Mod folder and start its RPC or socket server from a workbench toolbar; then Claude Desktop or Claude Code launches the MCP server, often with uvx, which talks to that listener on localhost.

Which FreeCAD versions work?

Most current servers document FreeCAD 1.0 and 1.1, and one requires 1.0.2 or later with 1.1.4 recommended for security fixes. An older macro-based plugin supports 0.21. CAM toolpath tools in one server need a FreeCAD weekly build, because the Path API changed after 1.1.

Is it safe to let an AI run code in FreeCAD?

Treat it with care. Several servers run arbitrary Python with your user's permissions. Keep the listener on localhost, set the auth token or bearer token some servers offer before allowing remote access, and work on copies of important files.

Can FreeCAD run without the GUI for an agent?

Yes. FreeCAD's freecadcmd runs scripts headlessly, and some servers use it for exports and heavy geometry. If you want an agent to script models with no CAD program at all, look at the CadQuery, build123d and OpenSCAD pages.

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

Sources (checked 4 Nov 2026): FreeCAD Scripting Basics (FreeCAD wiki) · Headless FreeCAD (FreeCAD wiki) · neka-nat/freecad-mcp installation guide · FreeCAD news blog · FreeCAD product page

FreeCAD is developed by its own project (Open source). Tresca is independent and not affiliated with or endorsed by the FreeCAD project.