How do I install the freecad mcp mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

FreeCAD MCP Server

A server to interact with FreeCAD models using the Model Context Protocol (MCP).

Local serverstdioPython

What is the FreeCAD MCP Server?

A server to interact with FreeCAD models using the Model Context Protocol (MCP).

The short version

This repository is a FreeCAD MCP that allows you to control FreeCAD from Claude Desktop.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
create_document	Create a new document in FreeCAD.
create_object	Create a new object in FreeCAD.
edit_object	Edit an object in FreeCAD.
delete_object	Delete an object in FreeCAD.
execute_code	Execute arbitrary Python code in FreeCAD.
insert_part_from_library	Insert a part from the [parts library](https://github.com/FreeCAD/FreeCAD-library).
get_view	Get a screenshot of the active view.
get_objects	Get all objects in a document.
get_object	Get an object in a document.
get_parts_list	Get the list of parts in the [parts library](https://github.com/FreeCAD/FreeCAD-library).
run_fem_analysis	Run the CalculiX solver on an existing Fem::FemAnalysis and return summary results (max von Mises stress, max displacement, node count, working directory). Auto-creates a SolverCcxTools if the analysis has none. See [exa

How to install the FreeCAD MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use FreeCAD MCP to create document.”
“Use FreeCAD MCP to create object.”
“Use FreeCAD MCP to edit object.”

Frequently asked questions

A server to interact with FreeCAD models using the Model Context Protocol (MCP). Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.