Atlas / MCP servers / bonninr / FreeCAD

FreeCADBLOCK

mcp/bonninr/freecad

FreecadMCP connects Freecad to Claude AI and other MCP-ready tools like Cursor through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Freecad. This integration enables prompt assisted CAD 3d Design.

Verdict
BLOCK
Grade
D
Trust score
69 /100
Exposed tools
2 0r · 2w · 0d
Transport
stdio
License
MIT
Stars
229
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

Overview

The FreeCAD MCP (Model Control Protocol) provides a simplified interface for interacting with FreeCAD through a server-client architecture. This allows users to execute commands and retrieve information about the current FreeCAD document and scene.

https://github.com/user-attachments/assets/5acafa17-4b5b-4fef-9f6c-617e85357d44

Configuration

To configure the MCP server, you can use a JSON format to specify the server settings. Below is an example configuration:

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

Configuration Details

  • command: The path to the Python executable that will run the FreeCAD MCP server. This can vary based on your operating system:
  • Windows: Typically, it might look like C:\\ProgramData\\anaconda3\\python.exe or C:\\Python39\\python.exe.
  • Linux: It could be /usr/bin/python3 or the path to your Python installation.
  • macOS: Usually, it would be /usr/local/bin/python3 or the path to your Python installation.
  • args: An array of arguments to pass to the Python command. The first argument should be the path to the freecad_bridge.py script, which is responsible for handling the MCP server logic. Make sure to adjust the path according to your installation.

Example for Different Operating Systems

Windows

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

Linux

{
"mcpServers": {
"freecad": {
"command": "/usr/bin/python3",
"args": [
Read from source at commit 3b0f00d32ffaOBSERVED · 2026-10-06
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.

claude-code
claude mcp add freecad-mcp -- uvx freecad-mcp
claude-desktop
{
  "mcpServers": {
    "freecad-mcp": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}
03

Exposed tools (2)

0 read · 2 write · 0 destructive.

ToolRiskDescription
run_scriptwriteRun an arbitrary Python script in FreeCAD context.
send_commandwriteSend a command to FreeCAD and get document context information.
04

Trust audit

BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (1 observation(s))
Network
declared (5 observation(s))
Shell
declared (3 observation(s))
Dependencies
pinned
Secrets in source
none-found

Findings (4)

HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
addon.py:365
exec(code, namespace)
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
freecad_mcp.py:135
exec(command, {"App": App, "Gui": Gui})
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
freecad_mcp.py:164
exec(script, namespace)
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
INFOInventory / provenance · inv.oversize · CWE-1104
assets/freecad.mp4
assets/freecad.mp4
Why it matters. 2959457 bytes not read

Gates applied: no_behavioural_pass.

Audited 2026-10-06 · audit v0.4.1 · source sha 3b0f00d32ffafull audit observations/trust-audit/mcp-server/bonninr__freecad.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-063b0f00d32ffaBLOCKD69first audit
06

Questions

What is the FreeCAD MCP server?

FreecadMCP connects Freecad to Claude AI and other MCP-ready tools like Cursor through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Freecad. This integration enables prompt assisted CAD 3d Design.

What tools does FreeCAD expose?

2 in total: 0 read-only, 2 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is FreeCAD safe to connect to an agent?

No — not without reading the findings first. The audit graded it D (69/100) and found 3 critical or high issues in the source. Each one is listed on this page with the file and line it is on.

What credentials does FreeCAD need?

No credential environment variables were found in its source, so it appears to need none.

How does FreeCAD run?

It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as freecad-mcp.

How current is this page?

The grade is for one exact copy of the source (3b0f00d32ffa), read on 2026-10-06. The repository is watched and re-audited when it changes.

Advertisement