FreeCAD MCP
An MCP server to drive FreeCAD from Claude Desktop and other clients: create and edit models, run scripts and FEM analysis
- 3,310 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Executes arbitrary Python code inside FreeCAD
- Creates and changes documents and models in the application on the host
Install
- Works in
Manual install
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": ["freecad-mcp"]
}
}
}The MCP server runs through uvx. Separately install the FreeCADMCP addon and start the RPC server inside FreeCAD.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Executes arbitrary Python code inside FreeCAD
- Creates and changes documents and models in the application on the host
This is third-party code. Review the repository files before installing.
What it does
The server links an AI client to FreeCAD and lets an agent create and edit 3D models, read document contents, run Python scripts inside FreeCAD and launch finite-element analyses. It has two parts: an addon that runs inside FreeCAD and hosts an RPC server, and an MCP server the client launches through uvx. Connections use localhost by default. Through its tool set the agent can assemble a part from a description, build a model from a 2D drawing and design step by step. The repository includes ADK and LangChain integration examples and animated demos.
Who it is for. For engineers, designers and developers who model in FreeCAD with an AI agent.
Good fit when
- You need to create or change a 3D model in FreeCAD from a description
- You need to build a part from a 2D drawing
- You need to run a Python script or FEM analysis inside FreeCAD
Not a fit when
- FreeCAD is not installed or the addon with its RPC server is not running
- You only need FreeCAD advice without controlling the application
Example request
Create a flange with four bolt holes in FreeCAD from this sketchMCP
- Transport
- stdio
- Authentication
- not required
Limitations
It requires FreeCAD with the FreeCADMCP addon installed and its RPC server running inside the program; connections use localhost by default. The MCP server runs through uv or uvx and needs Python 3.12 or newer. The agent can execute arbitrary Python code inside FreeCAD, so run it only with trusted requests.
How to disable. Remove the server from the client's MCP configuration and delete the FreeCADMCP addon from the FreeCAD addon directory.
FAQ
What must be running for the server to work?
FreeCAD with the FreeCADMCP addon installed and its RPC server started via the Start RPC Server button in the FreeCAD MCP toolbar.
Which clients does it work with?
Claude Desktop and other MCP clients. The repository also includes ADK and LangChain integration examples.
How is FreeCAD MCP different from Python scripts for FreeCAD?
The server links an AI client to FreeCAD: the agent creates and edits 3D models, reads documents, runs Python scripts inside FreeCAD and launches finite element analysis. You do not write the scripts yourself.
How do I connect an MCP for FreeCAD?
Add the freecad server with the uvx command to the client config, as in the install block, and start FreeCAD with the needed addon. The server works in Claude Desktop, Claude Code and Cursor. Risk is high because the agent runs code in FreeCAD.
Discussion
No questions or reviews yet.
Related
MCP serversThe MCP server connects agents to FreeCAD for part modeling, document edits, macro execution and model export.
An MCP server for AutoCAD, GstarCAD and ZWCAD: draw, edit and inspect drawings in plain language
AutoCAD MCP Pro
autocad-mcp-pro
An MCP server for AutoCAD with hundreds of tools: a live AutoCAD through COM or DXF without the program, with a token saving mode
AutoCAD MCP
autocad-mcp
An MCP server for AutoCAD LT: the agent draws and edits drawings through AutoLISP, and without AutoCAD writes DXF files
McNeel's MCP server for Rhino 3D: Claude, Codex and Gemini CLI model geometry in an open Rhino and build Grasshopper definitions
Fusion 360 MCP
fusion360-mcp-server
An MCP server for Autodesk Fusion 360: the agent builds sketches and solids, edits parameters and runs commands in an open project
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| FreeCAD MCP (this card) | no | not required | 3,310 | |
| Fusion 360 MCP | no | not required | 148 | drives Fusion 360 through an add-in, Beta status |
| SketchUp MCP | no | not required | 60 | drives SketchUp through an extension, with eval_ruby |
README in short
The README describes an MCP server for controlling FreeCAD from Claude Desktop and other clients: creating and editing models, running scripts, reading documents and FEM analysis. The project has an addon that hosts an RPC server inside FreeCAD and an MCP server launched through uvx. The quick start shows how to clone the repository, copy the addon, start the RPC server and add a freecad server to the client configuration. Separate guides cover installation, configuration, tools, code execution and examples. MIT licensed.