Summary
The FreeCAD MCP server enables Claude Desktop to control FreeCAD through an MCP interface, allowing users to design 3D models and parts by conversing with Claude. It provides tools for creating 3D geometry, converting 2D drawings to 3D designs, and manipulating FreeCAD projects remotely via an RPC server that integrates with Claude's context protocol. This server solves the problem of programmatic access to FreeCAD's design capabilities, enabling AI-assisted CAD modeling without direct manual interaction with the FreeCAD GUI.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
FreeCAD MCP
Control FreeCAD from Claude Desktop and other MCP clients. Create and edit models, run Python scripts, inspect documents, and run FEM analyses.
Demo
Design a flange:
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.
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →UpdatedMar 8, 2026