FreeCAD MCP: Real-Time 3D Cloud Collaboration

FreeCAD MCP Server: Unleash real-time 3D design collaboration in the cloud. Engineers, innovate fearlessly—your blueprint to smarter engineering just got brighter.

Visit Repository

✨ Developer Tools

4.7(37 reviews)

55 saves

25 comments

Ranked in the top 1% of all AI tools in its category

About FreeCAD MCP

What is FreeCAD MCP: Real-Time 3D Cloud Collaboration?

FreeCAD MCP is an advanced collaboration tool enabling real-time 3D design synchronization between multiple users via cloud integration. This middleware platform connects FreeCAD with Claude Desktop, allowing remote teams to collaborate seamlessly on CAD projects through a unified interface. Unlike traditional file-sharing workflows, MCP ensures instantaneous updates and version control across all connected devices.

How to Use FreeCAD MCP: Real-Time 3D Cloud Collaboration?

Implementing FreeCAD MCP involves three core steps: addon installation, Claude Desktop configuration, and RPC server initialization. First, place the FreeCADMCP directory into your system-specific FreeCAD addon folder:

Windows: %APPDATA%\FreeCAD\Mod\
macOS: ~/Library/Application Support/FreeCAD/Mod/
Linux: ~/.FreeCAD/Mod/ or snap-based paths

Next, configure claude_desktop_config.json with server parameters. For developers, include the repository path using uv command syntax. Finally, activate the MCP Addon workbench and launch the RPC server through FreeCAD's dedicated toolbar interface.

FreeCAD MCP Features

Key Features of FreeCAD MCP

Central to its functionality are these enterprise-grade capabilities:

Real-time synchronization across multiple CAD sessions
Remote code execution via execute_code API
Library integration with official FreeCAD part repositories
Granular object management through creation/edit/delete APIs
Support for multi-user session tracking in cloud environments

These features are exposed through a RESTful API interface, making them accessible to automation scripts and custom workflows.

Use Cases of FreeCAD MCP

Practical applications include:

Industrial Design Collaboration: Engineers can simultaneously refine a toy car model (see demo), with each team member's changes appearing instantly.

Rapid Prototyping: Teams accelerate product development by sharing design iterations in real-time, eliminating version sync delays. The fillet design workflow demonstrates this capability effectively.

Remote Troubleshooting: Support teams can execute diagnostic code remotely using execute_code

FreeCAD MCP FAQ

FAQ from FreeCAD MCP

Q: How do I ensure compatibility with snap-installed FreeCAD?
A: Use the ~/snap/freecad/common/Mod/ path for addon placement when installed via snap packages.

Q: Can I customize RPC server parameters?
A: Yes, edit claude_desktop_config.json to adjust port numbers or security settings before initialization.

Q: What happens if multiple users edit the same object?
A: The system implements optimistic concurrency control, displaying edit conflicts for manual resolution when necessary.

Content

FreeCAD MCP

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

Demo

Design a filet

demo

Design a toy car

demo

Install addon

FreeCAD Addon directory is

Windows: %APPDATA%\FreeCAD\Mod\
Mac: ~/Library/Application Support/FreeCAD/Mod/
Linux: ~/.FreeCAD/Mod/ or ~/snap/freecad/common/Mod/ (if you install FreeCAD from snap)

Please put addon/FreeCADMCP directory to the addon directory.

When you install addon, you need to restart FreeCAD. You can select "MCP Addon" from Workbench list and use it.

workbench_list

And you can start RPC server by "Start RPC Server" command in "FreeCAD MCP" toolbar.

start_rpc_server

Setting up Claude Desktop

Edit claude_desktop_config.json file.

For user.

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

For developer. First, you need clone this repository.

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



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

Tools

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