home / mcp / freecad mcp server

FreeCAD MCP Server

FreeCAD MCP(Model Context Protocol) server

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can control FreeCAD from Claude Desktop using the FreeCAD MCP server. It lets you automate document creation, modify objects, run Python code, insert parts from libraries, and capture views, all through MCP commands and the Claude integration. This guide shows you how to install the addon, start the RPC server, and configure Claude Desktop to talk to FreeCAD MCP.

How to use

Install the FreeCAD MCP addon in FreeCAD, then start the RPC server from the FreeCAD MCP toolbar to enable remote control. In Claude Desktop, configure the MCP server so Claude can send commands to FreeCAD. You can perform common tasks such as creating a new document, creating and editing objects, inserting parts from the library, executing Python code, and taking screenshots of the active view.

Typical workflows you can run include: creating a new FreeCAD document, adding objects, applying edits, running Python scripts to automate modeling steps, and exporting or viewing results. You can also use the library to insert predefined parts and inspect the resulting model by capturing the current view.

How to install

Prerequisites: you need FreeCAD installed on your system. You also need Claude Desktop if you plan to use Claude for MCP interactions.

1) Install the FreeCAD MCP addon into FreeCAD.

2) Install the addon by cloning the repository and copying it into FreeCAD’s Mod folder.

git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

3) Restart FreeCAD after the addon is installed, then select the MCP Addon from the Workbench list and use it.

4) Start the RPC server from the FreeCAD MCP toolbar with the Start RPC Server command.

Set up Claude Desktop to talk to the MCP server. You must pre-install uvx and configure claude_desktop_config.json.

User configuration for Claude Desktop

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

If you want to save a token and use only text feedback, you can add the --only-text-feedback flag.

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

Developer configuration (alternative runtime) for Claude Desktop

{
  "mcpServers": {
    "freecad": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/freecad-mcp/",
        "run",
        "freecad-mcp"
      ]
    }
  }
}

Additional setup notes

The addon directory should be placed under your FreeCAD Mod/ directory for your OS. FreeCAD will require a restart after the addon is installed. After that, select the MCP Addon from the Workbench list and start the RPC Server to enable remote control.

Available tools

create_document

Create a new FreeCAD document and initialize its workspace.

create_object

Add a new object to the active FreeCAD document with specified properties.

edit_object

Modify properties of an existing FreeCAD object in the document.

delete_object

Remove an object from the document.

execute_code

Run arbitrary Python code inside FreeCAD’s scripting environment.

insert_part_from_library

Insert a predefined part from the parts library into the current document.

get_view

Capture and return a screenshot of the active FreeCAD view.

get_objects

List all objects in the current FreeCAD document.

get_object

Retrieve details about a specific object in the document.

get_parts_list

Provide the list of parts available in the parts library.