neka-nat/freecad-mcp

3.1K stars 364 forks Quality 77 Trend 67MIT

FreeCAD MCP(Model Context Protocol) server

Overview

This repository is a FreeCAD MCP that allows you to control FreeCAD from Claude Desktop. This is the conversation history. https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48 FreeCAD Addon directory is * Windows: %APPDATA%\FreeCAD\Mod\ * Mac: * FreeCAD 1.1: ~/Library/Application\ Support/FreeCAD/v1-1/Mod/ * FreeCAD 1.0: ~/Library/Application\ Support/FreeCAD/v1-0/Mod/ * Linux: * Ubuntu: ~/.FreeCAD/Mod/ or ~/snap/freecad/common/Mod/ (if you install FreeCAD from snap) * Debian: ~/.local/share/FreeCAD/Mod * Arch / CachyOS (FreeCAD 1.1 from extra/freecad): ~/.local/share/FreeCAD/v1-1/Mod/ 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. And you can start RPC server by "Start RPC Server" command in "FreeCAD MCP" toolbar. By default, the RPC server must be started manually each time FreeCAD opens. To start it automatically: 1.

README

FreeCAD MCP

Control FreeCAD from Claude Desktop and other MCP clients. Create and edit models, run Python scripts, inspect documents, and run FEM analyses.

Demo

Design a flange:

See more demos and examples for a toy car, modelling from a 2D drawing, and agent integrations.

Quick start

You need FreeCAD and uv / uvx. FreeCAD MCP has two components: an addon running inside FreeCAD and an MCP server launched by your client.

1. Install and start the FreeCAD addon

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

Copy addon/FreeCADMCP into your FreeCAD addon directory, then restart FreeCAD. Select the MCP Addon workbench and click Start RPC Server in the FreeCAD MCP toolbar.

See the installation guide for platform-specific commands and screenshots.

2. Connect Claude Desktop

Add the following entry to claude_desktop_config.json:

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

Restart Claude Desktop to load the configuration, keep FreeCAD open with its RPC server running, and ask Claude to create a model. Connections use localhost by default.

Documentation

Guide	Contents
Installation	Addon directories, setup screenshots, running from source
Configuration	Auto-start, text feedback, remote connections
Tools	Available tools, screenshots, FEM analysis
Code execution	GUI execution, background jobs, headless scripts, timeout troubleshooting
Demos and examples	Design demos, FEM example, ADK and LangChain integrations

Contributors

Made with contrib.rocks.

View the full README on GitHub

Install

uvx freecad-mcp

New to MCP? Start with the mcpskill.org guide →

Configuration

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