FreeCAD MCP Server (bonninr/freecad_mcp)

Name: FreeCAD MCP Server (bonninr/freecad_mcp)
Author: bonninr

@bonninr

Repository

Basic information

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

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

Before you connect

Documentation reviewed 2026-10-25

When to choose this server

This bonninr integration connects an MCP client to a local FreeCAD workbench and bridge. It exposes scene inspection and Python execution in FreeCAD.

Setup and limitations

Install the workbench in FreeCAD’s Mod directory and point your client at the actual Python executable and freecad_bridge.py. The README’s Windows paths are examples, not portable defaults. Start with get_scene_info before running a script that changes a model.

These notes check the linked documentation, not a live authenticated connection. Suggested checks are steps for you to run.

Read upstream documentation Compare related servers

FreeCAD MCP Server 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"
      ]
    }
  }
}

FreeCAD MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

FAQ from Freecad

—

Comments

More Other MCP servers

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

ICSS

chokcoco

不止于 CSS

20.7K