!Designing a flange in FreeCAD

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.