Skip to content
Tresca

FreeCAD AI

PluginCommunity

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

615 starsUpdated 3 weeks agoGitHub data from 5 Nov 2026

At a glance

Type
Plugin
Works with
FreeCAD
How it connects
Drives a running copy of the tool
Access
Can modify models
Tool versions
FreeCAD 1.0+ (tested with 1.0.2 and 1.1.0)
Operating systems
Windows, macOS, Linux
Needs a FreeCAD licence
No
Transport
Local (stdio), Remote (HTTP)
AI clients documented
Claude Code, Claude Desktop
Licence
LGPL-2.1
Language
Python

What it can do

  • Adds a chat dock inside FreeCAD that works with 24 LLM providers, including local Ollama, with Plan mode to review code and Act mode to run it.
  • Offers 50 structured FreeCAD operations plus skills for enclosures, gears, fastener holes and sketch-from-image.
  • Starts an MCP server from the toolbar so outside clients such as Claude Code can use the same tools on the open document, or a headless stdio server through FreeCAD's command line.
  • Sends failed code back to the model for up to three automatic retries.

Limitations

  • Alpha; the author warns of breaking changes and occasional FreeCAD crashes from generated code.
  • The MCP server is unauthenticated by default and can run arbitrary Python; set a bearer token.

Install

ln -s /path/to/freecad-ai ~/.local/share/FreeCAD/Mod/freecad-ai

Source: github.com/ghbalf/freecad-ai#installation

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.