Freecad MCP

FreeCAD MCP

<!-- mcp-name: io.github.neka-nat/freecad-mcp --> <p align="left"> <a href="https://www.star-history.com/neka-nat/freecad-mcp"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=neka-nat/freecad-mcp&type=trending&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=neka-nat/freecad-mcp&type=trending" /> <img alt="GitHub Trending Repository of the Day" src="https://api.star-history.com/badge?repo=neka-nat/freecad-mcp&type=trending" /> </picture> </a> </p>

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

<a href="https://github.com/neka-nat/freecad-mcp/graphs/contributors"> <img src="https://contrib.rocks/image?repo=neka-nat/freecad-mcp" /> </a>

Made with contrib.rocks.