freecad-mcp
FreeCAD MCP(Model Context Protocol) server
Links
README
From the repo.
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.
Collected info
- ★ 2,401 stars
- ⎇ 296 forks
- Language: Python
- Source updated: 9/18/2026
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.
