I have been 3D designing long before I started 3D printing. At first, my program of choice for 3D work was Blender, but now that I’m making my own parts and need dimensional accuracy, CAD software works better. The problem, however, is that now I have to learn a whole new program.
I had already taught Claude 3D design in Blender, so I figured I could do the same for FreeCAD. All it took was some research, downloading, and copying a few files, and now Claude designs my 3D parts instead.
FreeCAD finally speaks Claude’s language
How the FreeCAD MCP server lets an AI control a real CAD application through conversation
FreeCAD is one of the most popular free and open-source CAD programs you’ll come across on the internet. FreeCAD MCP is another open-source project that implements a Model Context Protocol (MCP) server for FreeCAD. MCP is the next big thing in AI as it allows Claude and other AI apps like ChatGPT or Gemini to talk directly to external applications and tools that they wouldn’t otherwise be able to access.
The setup involves two pieces: a FreeCAD addon that you drop into the program’s Mod directory and an MCP server you register in Claude Desktop’s claude_desktop_config.json file. Once FreeCAD is running and the RPC server for the MCP is started from the MCP toolbar, Claude can see the active document (or create new ones) and start issuing commands in real time.
From this point onwards, you can talk to Claude in plain English, describe what you want, and the AI translates that into FreeCAD’s Python API calls behind the scenes. The model creates objects, edits them, runs boolean operations, and even captures viewport screenshots to visually verify what it just built. You can also see those changes in real-time in the FreeCAD window open on your PC.
- OS
-
Windows, Linux, macOS
- Developer
-
Neka-nat
- Price model
-
Free, Open-source
FreeCAD MCP is an open-source Model Context Protocol server that enables AI assistants like Claude to create, modify, and analyze parametric FreeCAD models using natural language.
Designing parts feels like giving instructions
Describe what you want in plain English and watch FreeCAD build it step by step
If you’ve dabbled in FreeCAD or any other CAD software, you know the drill. You design a sketch, constrain it, pad it, or apply other operations, and continue the cycle until you get the part you want. This might sound simple, but if you’re a total beginner, there are a lot of places that can get you stumped.
With FreeCAD MCP, however, the conversation feels natural. I didn’t have to learn any special prompt syntax. I describe whatever I want to make, let’s say a bracket, as a rectangular body 40mm wide, 20mm tall, and 4mm thick with two M3 mounting holes 30mm apart centered on the long axis, and Claude just makes the part. That’s it.
What you’re really doing is delegating FreeCAD’s Python scripting layer to the model. Every operation Claude performs goes through the same API you’d use if you were writing a macro by hand, meaning the resulting model is fully parametric. You can go back into FreeCAD and tweak the sketch or change a dimension manually at any time, and the rest of the part will update automatically. It’s pretty much the same workflow I use when editing photos with Claude.
It excels at practical, functional models
Brackets, mounts, enclosures, and replacement parts are where this workflow really shines
This workflow works best for two kinds of tasks: parts with repetitive geometry and parts that start from a 2D drawing or description you already have in text form.
Repetitive geometry is where the time saving is massive. Flanges, mounting plates with bolt patterns, enclosures with symmetric cutouts, or any kind of part where you spend a majority of your time constraining sketches instead of actually designing. I often use this workflow for adding Ikea Skadis pegboard hooks for enclosures and trays that need to go on my tool pegboard. I just designed the part, and once I’m done, I ask Claude to add Skadis hooks, and it automatically does so, keeping in mind the part’s dimensions.
The second standout use case is designing from an existing drawing or specification. If you’re designing a part from scratch, it’s best to make some 2D sketches in at least one plane and hand that design off to Claude. You don’t have to be super precise in your sketch, either. As long as you get the basic geometry right, Claude will figure out the rest. You can always go back and correct any dimensions if needed.
It’s not replacing CAD expertise overnight
Complex assemblies, edge cases, and design refinement still need human intervention
As helpful as this MCP server is, it isn’t a magic wand for designing anything in FreeCAD. It’s best used as an assistant for tedious tasks with fixed dimensions and shapes that you’d rather hand off to Claude so you can focus on the actual design of the part. But if you’re trying to make an engineering-grade part using a two-line Claude prompt, you’re going to get some interesting (and not very accurate) results, to say the least.
Complex multi-body assemblies with intricate constraints can send Claude into an iteration loop where it keeps executing the same code and checking the viewport screenshot several times before landing on the final result. This might get you the result you wanted, but it’ll also burn a ton of tokens as those visual feedback loops add up. The configuration does offer an –only-text-feedback flag, which I highly recommend you implement as you’ll be able to see the finished result in FreeCAD anyway.
Other limitations include what you can communicate via natural language itself. Precise tolerance relationships, GD&T annotations, and sheet metal operations with specific bend reliefs can be hard to describe unambiguously. Claude will try, and sometimes even succeed, but you’d want to validate the output in FreeCAD’s measuring tools before sending anything to the slicer and wasting filament.
This is a completely different way to model
AI shifts CAD from drawing geometry to describing ideas
What FreeCAD MCP really does for you is drop the CAD skill ceiling required to use programs like FreeCAD to full effect. A side effect of that is that if you’re new to the program or CAD itself, you’ll learn much faster than any YouTube video or course has to offer.
For the kind of parts most makers and tinkerers actually print — brackets, enclosures, adapters, mounts — this workflow is much faster and less frustrating than spending hours trying to fight constraints. Install the addon, configure Claude Desktop, start a conversation, and describe your part. That’s all it takes.
- Developer
-
Anthropic PBC
- Price model
-
Free, subscription available
Claude is an advanced artificial intelligence assistant developed by Anthropic. Built on Constitutional AI principles, it excels at complex reasoning, sophisticated writing, and professional-grade coding assistance.
