Name: FreeCAD
Author: bonninr

LABSCO SUMMARY

Two tools, with the whole FreeCAD Python API behind them.

There are no per-object tools here. The model writes FreeCAD Python and the workbench runs it inside the application, then hands back the document's objects after a command. That keeps the surface tiny and puts everything FreeCAD can do within reach, but every call is arbitrary code running as you, so read what the model sends before you approve it.

What it is

A small bridge into a running FreeCAD. A workbench inside FreeCAD listens on localhost, and a Python MCP script forwards two tools to it: one runs a FreeCAD command and returns the document context, the other runs a whole script.

What you get

send_command runs FreeCAD Python and returns the active document with each object's name, type, placement and shape details, plus the view state
run_script runs a longer Python script with App, Gui and the active document already in scope, and reports whether it succeeded

Requirements

FreeCAD installed and open, with the freecad_mcp folder in its Mod directory, the FreeCAD MCP workbench selected and its server started from the panel. Your client runs src/freecad_bridge.py with a Python 3.10 or later that has the mcp package. MIT.

Setup effort

Build from source — git clone https://github.com/bonninr/freecad_mcp.git

See installation options

USE CASES

01

Turning a written spec into a first solid

Have the model write the FreeCAD Python that creates the primitives with their dimensions, run it, and check the objects the document reports back.

run_scriptsend_command

02

Correcting a dimension someone got wrong

Send one command that sets the property on the existing object, then read the returned document context to confirm the new value.

send_command

03

Automating a repetitive modelling step

Run a whole script against the active document, with App, Gui and doc already defined, instead of repeating the same clicks.

run_script

2 tools

Listed in project docs. Your client may show a different list.

`send_command`

Send a command to FreeCAD and get document context information.

Args: command: Command to execute in FreeCAD

Returns: JSON string containing:

Command execution result
Current document information
Active objects and their properties
View state

BEFORE YOU INSTALL

What to know first

Tools you get

2 tools named in the project's documentation.

Requires

FreeCAD, open, with the FreeCAD MCP workbench's server started
Python 3.10+ with the mcp package

Where it runs

All 3 documented clients run the server on your machine.

CONTEXT COST

Light Standing cost

Rated by the size of the 2 tool definitions that ride along on every turn, not by how many there are

INSTALLATION

Connect your client

You clone this one yourself.

Server setup

TERMINAL

git clone https://github.com/bonninr/freecad_mcp.git

Place the freecad_mcp directory in your FreeCAD modules directory, which is %APPDATA%/FreeCAD/Mod/ on Windows, ~/.FreeCAD/Mod/ on Linux and ~/Library/Preferences/FreeCAD/Mod/ on macOS.

Restart FreeCAD and select the "FreeCAD MCP" workbench from the workbench selector.

Click Show FreeCAD MCP Panel, then Start Server. FreeCAD listens on localhost:9876 while the panel says Server: Running.

Add the block for your system to your client. command is a Python that has the mcp package installed; args is src/freecad_bridge.py inside that Mod folder.

MCP Clients

Windows

WINDOWS · JSON

{
  "mcpServers": {
    "freecad": {
      "command": "C:\\ProgramData\\anaconda3\\python.exe",
      "args": [
        "C:\\Users\\<YOUR_USERNAME>\\AppData\\Roaming\\FreeCAD\\Mod\\freecad_mcp\\src\\freecad_bridge.py"
      ]
    }
  }
}

Linux

LINUX · JSON

{
  "mcpServers": {
    "freecad": {
      "command": "/usr/bin/python3",
      "args": [
        "/home/<YOUR_USERNAME>/.FreeCAD/Mod/freecad_mcp/src/freecad_bridge.py"
      ]
    }
  }
}

macOS

MACOS · JSON

{
  "mcpServers": {
    "freecad": {
      "command": "/usr/local/bin/python3",
      "args": [
        "/Users/<YOUR_USERNAME>/Library/Preferences/FreeCAD/Mod/freecad_mcp/src/freecad_bridge.py"
      ]
    }
  }
}

FreeCAD