freecad-mcp
installs/mo · pypistarsforks
How to install freecad-mcp?
neka-nat/freecad-mcp
$git clone https://github.com/neka-nat/freecad-mcpThis repository is a FreeCAD MCP that allows you to control FreeCAD from Claude Desktop.
README.md
| 1 | [](https://mseep.ai/app/neka-nat-freecad-mcp) |
| 2 | |
| 3 | # FreeCAD MCP |
| 4 | |
| 5 | This repository is a FreeCAD MCP that allows you to control FreeCAD from Claude Desktop. |
| 6 | |
| 7 | ## Demo |
| 8 | |
| 9 | ### Design a flange |
| 10 | |
| 11 |  |
| 12 | |
| 13 | ### Design a toy car |
| 14 | |
| 15 |  |
| 16 | |
| 17 | ### Design a part from 2D drawing |
| 18 | |
| 19 | #### Input 2D drawing |
| 20 | |
| 21 |  |
| 22 | |
| 23 | #### Demo |
| 24 | |
| 25 |  |
| 26 | |
| 27 | This is the conversation history. |
| 28 | https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48 |
| 29 | |
| 30 | ## Install addon |
| 31 | |
| 32 | FreeCAD Addon directory is |
| 33 | * Windows: `%APPDATA%\FreeCAD\Mod\` |
| 34 | * Mac: |
| 35 | * FreeCAD 1.1: `~/Library/Application\ Support/FreeCAD/v1-1/Mod/` |
| 36 | * FreeCAD 1.0: `~/Library/Application\ Support/FreeCAD/v1-0/Mod/` |
| 37 | * Linux: |
| 38 | * Ubuntu: `~/.FreeCAD/Mod/` or `~/snap/freecad/common/Mod/` (if you install FreeCAD from snap) |
| 39 | * Debian: `~/.local/share/FreeCAD/Mod` |
| 40 | * Arch / CachyOS (FreeCAD 1.1 from `extra/freecad`): `~/.local/share/FreeCAD/v1-1/Mod/` |
| 41 | |
| 42 | Please put `addon/FreeCADMCP` directory to the addon directory. |
| 43 | |
| 44 | ```bash |
| 45 | git clone https://github.com/neka-nat/freecad-mcp.git |
| 46 | cd freecad-mcp |
| 47 | |
| 48 | # For Linux (Ubuntu/Debian) |
| 49 | cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/ |
| 50 | |
| 51 | # For Linux (Arch/CachyOS, FreeCAD 1.1 from extra/freecad) |
| 52 | mkdir -p ~/.local/share/FreeCAD/v1-1/Mod/ |
| 53 | cp -r addon/FreeCADMCP ~/.local/share/FreeCAD/v1-1/Mod/ |
| 54 | |
| 55 | # For macOS (FreeCAD 1.1) |
| 56 | cp -r addon/FreeCADMCP ~/Library/Application\ Support/FreeCAD/v1-1/Mod/ |
| 57 | ``` |
| 58 | |
| 59 | When you install addon, you need to restart FreeCAD. |
| 60 | You can select "MCP Addon" from Workbench list and use it. |
| 61 | |
| 62 |  |
| 63 | |
| 64 | And you can start RPC server by "Start RPC Server" command in "FreeCAD MCP" toolbar. |
| 65 | |
| 66 |  |
| 67 | |
| 68 | ### Auto-Start RPC Server |
| 69 | |
| 70 | By default, the RPC server must be started manually each time FreeCAD opens. To start it automatically: |
| 71 | |
| 72 | 1. Open the **FreeCAD MCP** menu (switch to the MCP Addon workbench first) |
| 73 | 2. Check **Auto-Start Server** |
| 74 | |
| 75 | The setting is saved to `freecad_mcp_settings.json` and persists across sessions. On the next FreeCAD launch, the RPC server will start automatically once the application finishes loading. |
| 76 | |
| 77 | You can disable it at any time by unchecking **Auto-Start Server** in the same menu. |
| 78 | |
| 79 | ## Setting up Claude Desktop |
| 80 | |
| 81 | Pre-installation of the [uvx](https://docs.astral.sh/uv/guides/tools/) is required. |
| 82 | |
| 83 | And you need to edit Claude Desktop config file, `claude_desktop_config.json`. |
| 84 | |
| 85 | For user. |
| 86 | |
| 87 | ```json |
| 88 | { |
| 89 | "mcpServers": { |
| 90 | "freecad": { |
| 91 | "command": "uvx", |
| 92 | "args": [ |
| 93 | "freecad-mcp" |
| 94 | ] |
| 95 | } |
| 96 | } |
| 97 | } |
| 98 | ``` |
| 99 | |
| 100 | If you want to save token, you can set `only_text_feedback` to `true` and use only text feedback. |
| 101 | |
| 102 | ```json |
| 103 | { |
| 104 | "mcpServers": { |
| 105 | "freecad": { |
| 106 | "command": "uvx", |
| 107 | "args": [ |
| 108 | "freecad-mcp", |
| 109 | "--only-text-feedback" |
| 110 | ] |
| 111 | } |
| 112 | } |
| 113 | } |
| 114 | ``` |
| 115 | |
| 116 | |
| 117 | For developer. |
| 118 | First, you need clone this repository. |
| 119 | |
| 120 | ```bash |
| 121 | git clone https://github.com/neka-nat/freecad-mcp.git |
| 122 | ``` |
| 123 | |
| 124 | ```json |
| 125 | { |
| 126 | "mcpServers": { |
| 127 | "freecad": { |
| 128 | "command": "uv", |
| 129 | "args": [ |
| 130 | "--directory", |
| 131 | "/path/to/freecad-mcp/", |
| 132 | "run", |
| 133 | "freecad-mcp" |
| 134 | ] |
| 135 | } |
| 136 | } |
| 137 | } |
| 138 | ``` |
| 139 | |
| 140 | ## Remote Connections |
| 141 | |
| 142 | By default the RPC server does not accept remote connections and listens on `localhost`. To control FreeCAD from another machine on your network: |
| 143 | |
| 144 | ### 1. Enable remote connections in FreeCAD |
| 145 | |
| 146 | In the **FreeCAD MCP** toolbar: |
| 147 | |
| 148 | 1. Check **Remote Connections** — the RPC server will bind to `0.0.0.0` (all interfaces) on the next restart. For security reasons, it only accepts connections from the IP addresses or CIDR subnets specified in the **Allowed IPs** field. By default this is `127.0.0.1`. |
| 149 | 2. Click **Configure Allowed IPs** and enter a comma-separated list of IP addresses or CIDR subnets that are allowed to connect, e.g.: |
| 150 | |
| 151 | ``` |
| 152 | 192.168.1.100, 10.0.0.0/24 |
| 153 | ``` |
| 154 | |
| 155 | `127.0.0.1` is always the |
People who liked this also viewed
6 picksType
- Figma-Context-MCPMCP server to provide Figma layout information to AI coding agents like CursorMCP ServersJul 2026
- sunnysideFigma-Context-MCPA comprehensive Model Context Protocol (MCP) server that bridges Figma designs with AI development workflows. It provides 30 specialized tools for extracting pixel-perfect code, assets, and component structures directly from Figma designs.MCP ServersApr 2026
- figma-console-mcpYour design system as an API. Connect AI to Figma for extraction, creation, and debugging.MCP ServersJul 2026
- dcc-mcp-coreCore runtime and shared tooling for DCC-MCP: safe, skill-first MCP integration across Maya, Blender, Houdini, Photoshop, and custom DCC hosts.MCP ServersJul 2026
- godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.MCP ServersJul 2026
- kicad-mcp-proAI-ready MCP server for KiCad: automate schematic, PCB, ERC/DRC, DFM, BOM and manufacturing review from Claude, Cursor, Copilot and other AI agents.MCP ServersJul 2026
