FreeCADBLOCK
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.
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.exeorC:\\Python39\\python.exe. - Linux: It could be
/usr/bin/python3or the path to your Python installation. - macOS: Usually, it would be
/usr/local/bin/python3or 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.pyscript, 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": [
3b0f00d32ffaOBSERVED · 2026-10-06Connect
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 mcp add freecad-mcp -- uvx freecad-mcp
{
"mcpServers": {
"freecad-mcp": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Exposed tools (2)
0 read · 2 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
run_script | write | Run an arbitrary Python script in FreeCAD context. |
send_command | write | Send a command to FreeCAD and get document context information. |
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.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (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)
exec(code, namespace)
exec(command, {"App": App, "Gui": Gui})exec(script, namespace)
assets/freecad.mp4
Gates applied: no_behavioural_pass.
3b0f00d32ffafull audit observations/trust-audit/mcp-server/bonninr__freecad.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-06 | 3b0f00d32ffa | BLOCK | D | 69 | first audit |
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.