FreeCAD MCP

Control FreeCAD via MCP to create and modify 3D models, automate CAD tasks, solve constraints, and integrate part libraries programmatically.

FreeCAD MCP Skill

Enable AI agents to control FreeCAD via the Model Context Protocol (MCP). Create 3D models programmatically, generate parts from descriptions, and automate CAD workflows.

Features

• 🦾 Full FreeCAD control via RPC server
• Create 3D objects from 2D drawings
• Automatic constraint solving
• Part library integration
• Compatible with LangChain and Google ADK agents

Requirements

• FreeCAD 0.21+ installed
• Python 3.10+
• MCP-enabled AI agent

Installation

1. Install the skill

npx clawhub install openclaw-freecad-mcp

2. Install the FreeCAD addon

Copy the addon/FreeCADMCP folder to your FreeCAD addons directory:

• macOS: ~/Library/Application Support/FreeCAD/Mod
• Linux: ~/.FreeCAD/Mod
• Windows: %APPDATA%\FreeCAD\Mod

3. Start the RPC server

In FreeCAD, go to Workbenches → FreeCAD MCP → Start RPC Server

4. Configure your agent

Add the MCP server endpoint to your agent configuration:

{
  "mcpServers": {
    "freecad": {
      "url": "http://localhost:9876"
    }
  }
}

Usage

Example agent prompts:

• "Create a 50x50x10 mm cube with a centered 20mm hole"
• "Turn this 2D sketch into a 3D printable model"
• "Design a toy car body with integrated axles"

Examples

See the examples/ directory for:

• LangChain React agent example
• Google ADK agent example

Author

mars720816

License

MIT