MCP.so
Sign In

FreeCAD MCP

@neka-nat

Repository

About FreeCAD MCP

FreeCAD MCP(Model Context Protocol) server

#mcp#freecad#claude

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

neka-nat

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

11

Create a new document in FreeCAD.

Create a new object in FreeCAD.

Edit an object in FreeCAD.

Delete an object in FreeCAD.

Execute arbitrary Python code in FreeCAD.

Insert a part from the [parts library](https://github.com/FreeCAD/FreeCAD-library).

Get a screenshot of the active view.

Get all objects in a document.

Get an object in a document.

Get the list of parts in the [parts library](https://github.com/FreeCAD/FreeCAD-library).

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 [`examples/cantilever_fem.py`](examples/cantilever_fem.py) for an end-to-end usage example.

Overview

What is FreeCAD MCP?

FreeCAD MCP is a Model Context Protocol (MCP) server that enables you to control FreeCAD, the open-source parametric 3D CAD modeler, directly from Claude Desktop. It is designed for users who want to automate CAD design tasks, generate parts from descriptions or drawings, or integrate FreeCAD with AI-based workflows.

How to use FreeCAD MCP?

Install the FreeCAD MCP addon by copying the addon/FreeCADMCP directory to your FreeCAD Mod folder (paths differ by OS). Then restart FreeCAD, switch to the “MCP Addon” workbench, and click “Start RPC Server” in the toolbar. Configure Claude Desktop by editing claude_desktop_config.json to use uvx freecad-mcp as the MCP server command. Optionally enable auto-start of the RPC server via the FreeCAD MCP menu, or set up remote connections with --host and allowed IPs.

Key features of FreeCAD MCP

  • Create, edit, and delete FreeCAD objects via natural language
  • Execute arbitrary Python code in FreeCAD’s environment
  • Insert parts from the FreeCAD parts library
  • Capture screenshots of the active 3D view
  • Run CalculiX FEM analysis and retrieve summary results
  • Support for remote connections over a network
  • Auto-start RPC server on FreeCAD launch

Use cases of FreeCAD MCP

  • Design mechanical parts (e.g., a flange or toy car) from user descriptions
  • Generate 3D models from 2D technical drawings
  • Automate repetitive CAD operations with AI-driven prompts
  • Perform finite element analysis (FEM) on models and inspect results
  • Manage multiple documents and objects in FreeCAD remotely via Claude

FAQ from FreeCAD MCP

What tools are available in FreeCAD MCP?

The server provides 11 tools: create_document, create_object, edit_object, delete_object, execute_code, insert_part_from_library, get_view, get_objects, get_object, get_parts_list, and run_fem_analysis.

How do I enable remote connections to FreeCAD MCP?

In the FreeCAD MCP toolbar, check Remote Connections to bind to 0.0.0.0. Then use Configure Allowed IPs to specify comma-separated IP addresses or CIDR subnets. On the Claude Desktop side, pass the --host flag with the FreeCAD machine’s IP address or hostname.

How can I make the RPC server start automatically?

Switch to the MCP Addon workbench, open the FreeCAD MCP menu, and check Auto-Start Server. The setting is saved to freecad_mcp_settings.json and persists across sessions.

Is a Python environment required to run FreeCAD MCP?

Yes. Pre-installation of uvx (from the Astral uv tool) is required for the Claude Desktop configuration.

Can I receive only text feedback without image data?

Yes. Add the --only-text-feedback flag in the claude_desktop_config.json args to disable image-based feedback and use only textual responses.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K