FreeCAD MCP Server

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

• https://github.com/neka-nat/freecad-mcp
• https://github.com/neka-nat/freecad-mcp/blob/main/README.md
• https://github.com/neka-nat/freecad-mcp/blob/main/pyproject.toml
• https://pypi.org/pypi/freecad-mcp/json

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.

• Source repositorygithub.com 2026-07-21T05:19:43+00:00
• Documentationgithub.com
• Submitted by oktofeesh12026-06-05