FreeCAD MCP · neka-nat — Claude Code MCP server: what it does, how to install
MCP server for Claude Code and other clients controls FreeCAD models locally.
MIT ★ 3,427 updated 2026-11-16
claude mcp add freecad-mcp -- uvx freecad-mcpWhat FreeCAD MCP does
The tool connects the open-source CAD system to AI assistants via the Model Context Protocol. The architecture combines an in-app addon with an external server launched through uvx.
The integration lets users build and edit three-dimensional models, execute Python scripts, inspect project files, and run finite element method analyses. Setup requires FreeCAD and the uv package manager.
Clients connect over localhost by default.
What it helps with
- create a 3D model from a prompt
- execute a Python script in CAD
- run a finite element analysis
- inspect project document structure
Example prompts for the agent
- Design a mechanical flange model
- Run an FEM analysis on the assembly
- Execute a custom Python script inside the CAD
How to install FreeCAD MCP
Platform CLI
claude mcp add freecad-mcp -- uvx freecad-mcpuvx runs the command named after the package; if the README names another one, use uvx --from freecad-mcp <command>
Platform CLI
codex mcp add neka-nat-freecad-mcp -- uvx freecad-mcpuvx runs the command named after the package; if the README names another one, use uvx --from freecad-mcp <command>
Config file
{
"mcpServers": {
"neka-nat-freecad-mcp": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from freecad-mcp <command>
Config file
{
"servers": {
"neka-nat-freecad-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from freecad-mcp <command>
Platform CLI
gemini mcp add neka-nat-freecad-mcp uvx freecad-mcpuvx runs the command named after the package; if the README names another one, use uvx --from freecad-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about FreeCAD MCP
How to install FreeCAD MCP in Claude Code?
Run the command claude mcp add freecad-mcp -- uvx freecad-mcp in your terminal.
What does FreeCAD MCP do?
It lets AI assistants control FreeCAD, build 3D models, execute code, and perform engineering simulations.
What is needed to run FreeCAD MCP?
You need a local FreeCAD installation, the uv tool, and the RPC server running inside the CAD addon.
Similar MCP servers
All MCP servers for Game dev and 3D: Unity, Unreal, Godot, Blender →FreeCAD MCP by other authors comes first.