FreeCAD MCP Plugin (ATOI-Ming)

MCP serverCommunity

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

101 starsUpdated 5 months 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 0.21 or higher
Operating systems: Windows, macOS, Linux
Needs a FreeCAD licence: No
Transport: Local (stdio)
AI clients documented: Not stated in its documentation
Licence: MIT
Language: Python

What it can do

Creates, updates, validates and runs FreeCAD macro files, adding standard imports and a recompute step automatically.
Switches between front, top, right and axonometric views and returns the report log.
Adds a workbench with a panel to start and stop the server and view logs.

Limitations

The README's examples assume Anaconda for Python dependencies.
Version 0.1.0; modelling goes through macros rather than named modelling tools.

Install

{
    "mcpServers": {
        "freecad": {
            "disabled": false,
            "timeout": 60,
            "type": "stdio",
            "command": "D:\\Anaconda3\\python.exe",
            "args": ["D:\\FreeCAD\\Mod\\FreeCAD-MCP-main\\src\\freecad_mcp_client.py"]
        }
    }
}

Source: github.com/ATOI-Ming/FreeCAD-MCP#mcp-configuration

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.