freecad

This MCP server lets you control FreeCAD from Claude Desktop via the FreeCAD MCP addon. It exposes a set of actions (tools) such as creating and editing documents and objects, inserting parts from FreeCAD's library, executing arbitrary Python code, and retrieving views or object lists. With the server configured, you can issue commands from Claude Desktop to perform design tasks, automate workflows, or query the FreeCAD scene without switching contexts. The available tools include: create_document, create_object, edit_object, delete_object, execute_code, insert_part_from_library, get_view, get_objects, get_object, and get_parts_list. These enable end-to-end CAD operations, from setting up a document to modifying geometry and rendering quick previews.

Prerequisites:

• FreeCAD installed on the machine running the MCP server
• Claude Desktop configured with uvx as the MCP runner
• Python and uv (uvx) installed and accessible on PATH

Installation steps:

1. Clone the MCP repository for FreeCAD:

git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp

2. Install or prepare the uvx-based runner (per Claude Desktop docs). Ensure uvx is available in your PATH.
3. Install the MCP addon in FreeCAD according to the repository instructions (optional but recommended for direct integration):

# In FreeCAD, place the addon/FreeCADMCP directory into the FreeCAD Mod folder

4. Start the MCP server via uvx from Claude Desktop or your environment:

uvx freecad-mcp

5. If you want to run locally using a Python environment, you can install uvx via your environment and run the corresponding module if you have the freecad-mcp package prepared for local execution. See the repository’s developer setup instructions for details.

Note: The repository’s README describes both user and developer configurations for connecting Claude Desktop to the FreeCAD MCP server.

Tips and common issues:

• Ensure FreeCAD MCP addon is installed and FreeCAD is restarted after enabling the MCP addon.
• Remote connections: you can configure the MCP RPC server to listen on all interfaces and limit allowed IPs in FreeCAD’s GUI settings for security.
• When using Claude Desktop, set the mcpServers.freecad.command to uvx and the args to run freecad-mcp, or follow the developer approach to run via uv with the appropriate directory and script name.
• If you encounter connection issues, verify host/IP settings and that the server process is listening on the expected port/interface.
• The tools operate on the active FreeCAD session/document; use get_view to capture quick previews when scripting designs.