Freecad

Name: Freecad
Author: bonninr

@bonninr

About 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.

#freecad #model-control-protocol #3d-modeling

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Freecad?

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

How to use Freecad?

Install by placing the freecad_mcp directory in your FreeCAD modules directory, restart FreeCAD, and select the "FreeCAD MCP" workbench. Configure the MCP server in JSON format specifying the Python executable path and the path to freecad_bridge.py. Connect to the server via socket on localhost:9876 to send commands such as get_scene_info and run_script.

Key features of Freecad

Retrieve comprehensive scene information (document properties, objects, sketches, camera)
Execute arbitrary Python code within the FreeCAD context
Automate complex CAD operations via script
Modify existing objects and create new ones programmatically
Access shape properties, geometry, and constraints of sketches

Use cases of Freecad

Automate repetitive model creation tasks using Python scripts
Retrieve detailed information about the current FreeCAD document for analysis
Create and modify objects (e.g., add a box with custom dimensions) without manual interaction
Integrate FreeCAD with external tools by sending commands and receiving data