Skip to main content
hc
Submit
mcpSource-backedReview first Safety ✓ Privacy ✓

FreeCAD MCP Server

MCP server and FreeCAD add-on that lets Claude create, inspect, edit, delete, view, and analyze FreeCAD documents and objects through an RPC bridge.

by neka-nat·added 2026-06-05·
Claude CodeClaude Desktop
HarnessClaude CodeClaude Desktop
Review first — review before installing

Open the source and read safety notes before installing.

Safety notes

  • FreeCAD MCP can create, edit, and delete FreeCAD objects and documents.
  • The `execute_code` tool can run arbitrary Python code inside FreeCAD, so only use it with trusted prompts and human review.
  • Remote connections can bind the RPC server beyond localhost when enabled; keep allowed IPs narrow and restart the RPC server after changing access settings.
  • FEM analysis and part-library insertion can create files, use local compute, and modify active FreeCAD documents.
  • Screenshots and active-view feedback can expose proprietary CAD models or unreleased product designs.

Privacy notes

  • CAD geometry, object names, document structure, screenshots, Python code, prompts, RPC host settings, FEM summaries, part-library selections, and tool outputs may be visible to the MCP client and model provider.
  • FreeCAD documents may contain proprietary product designs, measurements, manufacturing details, customer data, or safety-critical engineering assumptions.
  • Avoid enabling remote access or auto-start behavior on shared networks unless the allowed IP list and host firewall are reviewed.
  • Keep generated CAD files and screenshots out of shared prompts, logs, and repositories unless they are approved for disclosure.

Prerequisites

  • FreeCAD installed and available on the machine running the FreeCAD add-on.
  • The repository's `addon/FreeCADMCP` directory copied into the correct FreeCAD add-on directory for the platform.
  • FreeCAD restarted, MCP Addon workbench selected, and the RPC server started.
  • uvx available to the MCP client runtime.
  • Remote connection settings, allowed IPs, and host flags reviewed before controlling FreeCAD from another machine.

Schema details

Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
20 minutes
Difficulty
advanced
Full copyable content
{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

About this resource

Content

FreeCAD MCP connects Claude-compatible MCP clients to FreeCAD through a FreeCAD add-on and Python MCP server. It can create documents, create and edit objects, delete objects, execute Python code inside FreeCAD, insert parts from the FreeCAD parts library, capture the active view, inspect objects, list parts, and run FEM analysis on an existing analysis.

The upstream README documents copying the addon/FreeCADMCP directory into the platform-specific FreeCAD add-on directory, restarting FreeCAD, starting the RPC server from the MCP Addon workbench, and launching the MCP server with uvx freecad-mcp.

Source Review

These sources were reviewed on 2026-06-05. Prefer the live repository, README, package metadata, and PyPI metadata for current add-on paths, tool list, remote-connection behavior, Python package version, and launch commands.

Features

  • Create new FreeCAD documents.
  • Create, edit, inspect, and delete FreeCAD objects.
  • Execute Python code inside FreeCAD.
  • Insert parts from the FreeCAD parts library.
  • Capture screenshots of the active FreeCAD view.
  • List available parts and current document objects.
  • Run CalculiX FEM analysis on an existing FreeCAD FEM analysis.
  • Use text-only feedback mode to reduce token usage.
  • Configure remote RPC connections with explicit allowed IPs.

Installation

Install the FreeCAD add-on first by copying addon/FreeCADMCP from the repository into the appropriate FreeCAD add-on directory for your platform. Restart FreeCAD, select the MCP Addon workbench, and start the RPC server.

For MCP clients that launch stdio servers:

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

For text-only feedback:

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp", "--only-text-feedback"]
    }
  }
}

Restart the MCP client after adding the server.

Use Cases

  • Ask Claude to create a basic CAD document from a natural-language description.
  • Inspect or modify existing FreeCAD objects.
  • Generate quick design iterations while reviewing each tool call.
  • Insert standard parts from the FreeCAD parts library.
  • Capture the active view for design feedback.
  • Run a FEM analysis summary on a prepared FreeCAD analysis.

Safety and Privacy

FreeCAD MCP can directly modify CAD documents and run arbitrary Python code inside FreeCAD. Treat it as a powerful local application-control bridge, not a read-only viewer. Review tool calls before allowing object deletion, code execution, remote RPC access, FEM solver runs, or changes to important models.

CAD files and screenshots may reveal product designs, dimensions, tolerances, manufacturing details, or customer projects. Keep the RPC server local by default, use strict allowed IPs for remote access, and avoid sharing extracted model data with a model provider unless the design is approved for disclosure.

Duplicate Check

No neka-nat/freecad-mcp entry, freecad-mcp package entry, or matching source URL was found in content/mcp.

#freecad#cad#engineering#python#3d

Source citations

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.