Get CADWiz in four steps.

Version 0.6.1 ยท Windows, Macintosh (macOS), and Linux. No sign-up, no email. Windows checked in an isolated setup. Mac is early and has not had a real-device test.

CADWiz is a smart CAD buddy that lives inside FreeCAD. You talk to it through the assistant app you already use.

Which assistant do you talk to?
Desktop apps only. The browser versions can’t connect to CADWiz.
Choose your operating system

On Linux, use FreeCAD with a supported local MCP client such as Codex CLI. The desktop assistant apps shown for Windows and Mac are not required.

Download CADWiz 0.6.1 for WindowsmacOSLinux The same ZIP includes helpers for Windows x64, Mac Apple Silicon / Intel, and Linux x64.
1

Have the two apps

You need FreeCAD and your assistant app. If you already have both, skip to step 2.

Install FreeCAD 1.1 or newer and set up your local Codex client. Install CADWiz through FreeCAD’s Addon Manager in step 2; the ZIP is also available above for manual installation.

Claude Desktop needs a Claude subscription and works on Windows and Mac.

ChatGPT Desktop needs a ChatGPT account. Use its Codex mode with CADWiz.

FreeCAD 1.1 or newerFree. From FreeCAD’s own website. On a Mac, pick Apple Silicon or Intel to match your Mac.
Get FreeCAD
Claude DesktopSign in with your Claude account.
Get Claude Desktop
ChatGPT DesktopSign in with your ChatGPT account.
Get ChatGPT Desktop
2

Install CADWiz in FreeCAD

  1. Open FreeCAD.
  2. Click the Tools menu, then Addon Manager.
  3. First time only: open the Addon Manager preferences. Under Custom repositories, press the add (+) button. Enter https://github.com/KingDragon8/cadwiz and branch main. Save the entry, close preferences and refresh the add-on list.
  4. Type CADWiz in the search box.
  5. Click Install.
  6. Close FreeCAD and open it again.
3

Connect your Linux clientConnect it to ClaudeChatGPT

  1. Open FreeCAD with CADWiz installed.
  2. In CADWiz, select ChatGPT, then Connect ChatGPT / Codex.
  3. Review the settings preview. CADWiz saves a backup before adding its entry to your local ~/.codex/config.toml.
  4. Start a new Codex CLI session so it reads the connection. Use Manual connection for another compatible local MCP client.

The bundled Linux x64 helper targets FreeCAD Python 3.11. Other Python builds need the advanced installation instructions in the README.

  1. Look at the CADWiz panel on the right side of FreeCAD.
  2. At the top of the panel, choose Claude.
  3. Press Add to Claude.
  4. Claude Desktop opens its own install screen. Click Install.

If the tools do not appear after installation, fully quit and reopen Claude. Upgrading from the old installer? The Add to Claude button backs up and retires only the old CADWiz entry, with Undo available; your other connectors are kept.

  1. Look at the CADWiz panel on the right side of FreeCAD.
  2. At the top of the panel, choose ChatGPT.
  3. Press Connect ChatGPT / Codex. The panel tells you what it will change, saves a backup, and makes the change.
  4. Fully close ChatGPT, then open it again.

Closing the window isn’t enough. Right-click ChatGPT’s icon by the clock and choose Quit.

Closing the window isn’t enough. With ChatGPT in front, press Command-Q.

4

Say hello

  1. In your new local client session, ask: What’s open in FreeCAD?
  2. The CADWiz light turns green when the client connects.
  1. Open a new chat in Claude Desktop.
  2. Say or type: What’s open in FreeCAD?
  3. Watch the light on the CADWiz panel turn green.
  1. Open ChatGPT Desktop and switch to Codex mode.
  2. Say or type: What’s open in FreeCAD?
  3. Watch the light on the CADWiz panel turn green.

Once you’re in, tell it which slicer and printer you use, in CADWiz Setup. You can also ask your assistant to save those workshop preferences for next time.

After that, just tell it what you want: “Make me a phone stand,” or “Make this 10 mm taller.”

If the light stays red, read the setup message. CADWiz checks local paths and its bundled helper offline. It repairs settings it previously created, with a backup and undo.

Something not right?

Ask your assistant for CADWiz help, or go to cadwiz.app/feedback. You don’t need a GitHub account.

To remove CADWiz

Use Undo connection to restore the previous CADWiz client entry, then remove CADWiz in FreeCAD’s Addon Manager. Your models and versions stay.

In Claude Desktop, open Settings, then Extensions, then CADWiz, then Uninstall. Then remove CADWiz in FreeCAD’s Addon Manager. Your models and their versions stay.

In the CADWiz panel, press Undo connection, which restores CADWiz’s previous entry while keeping other settings changes. Then remove CADWiz in FreeCAD’s Addon Manager. Your models and their versions stay.

Advanced: install by hand

Prefer to do it yourself? Download the CADWiz file and follow the steps in the README.

Available for Windows, Macintosh (macOS), and Linux. Linux uses a supported local MCP client; Claude Desktop is not offered here for Linux. The offline helper requires FreeCAD Python 3.11; the advanced installer is available for other builds.