freecad-mcp (contextform)
An MCP bridge for FreeCAD covering sketch creation, 3D operations like extrude and loft, parametric design, and file management.
What it does and how it connects
FreeCAD MCP from contextform lets Claude AI control FreeCAD through natural language: create 3D models, add features, and automate CAD workflows conversationally. The README demo is modelling a house from a simple text command, with walls, roof, windows, and door created automatically.
Installation is a two-command setup that detects the OS and FreeCAD installation, downloads the MCP files, installs the AI Copilot workbench, and registers the MCP bridge server. It requires FreeCAD 1.0 or later, Node.js and npm, and Claude Code, with manual config documented for Claude Desktop.
Once installed, the AI Copilot service starts automatically with FreeCAD, and the user asks Claude to design in plain language. The README states parametric features such as PartDesign pads from sketches, and the workflow is verified by asking Claude to check the FreeCAD connection and list the available tools.
Alternatives
Compare side by side- freecad-mcp (neka-nat)
The most widely used FreeCAD MCP server, with an addon plus server split and FEM analysis, rather than a two-command installer plus AI Copilot workbench.
- freecad-mcp (blwfish)
A FreeCAD MCP bridge built for daily use with 32 tools for modeling, CAM, and diagnostics, rather than a two-command installer bridge.
- freecad-addon-robust-mcp-server (spkane)
A FreeCAD MCP suite with 150 plus tools, headless mode, and connection resilience, rather than a two-command installer bridge.
- freecad_mcp (bonninr)
A minimal socket-based MCP workbench with two core commands, rather than an installer-driven bridge with an AI Copilot workbench.
Recurring errors it addresses
Error Index entries this tool is built to reduce or work around.
- A CAD agent bridge's screenshot tool refused any image over a 50KB socket frame, so every real model screenshot was dropped, and images that did fit arrived as base64 text inside JSON instead of real image blocks. The agent's only visual feedback channel was dead for production-scale models.Error Index
- When an agent fans out parallel create calls through the FreeCAD MCP bridge, the shared connection races: the first object is created even though its call reports failure, and the second object is silently never created with the status still showing healthy.Error Index
- A FreeCAD MCP bridge's autosave-before-call rewrote the active document on every tool call even with zero unsaved changes, stamping phantom diffs onto git-tracked CAD files. Agent activity pollutes version control with edits no human authored.Error Index
- A FreeCAD MCP bridge reported clean instance shutdowns as failures 100 percent of the time on Linux, because its liveness check polled immediately after signaling the process group. The agent was sent to retry or kill processes that were already gone.Error Index
- A FreeCAD MCP bridge silently ignored parameters the client materialized from JSON-Schema defaults, so box(size=20) produced a default 10mm shape. The agent believes it built the requested geometry while the model is something else entirely.Error Index
Sources
Not verified
- License: the GitHub API returns no license for this repo, so no license is stated.
- No GitHub releases exist, so latest release fields are null.
- No independent user voice found: recent issues are contributor feature work and pull requests.
- Pricing: none stated on the repo.
- Activity: last push August 2025, so the project looks quiet; no newer release was found.
Last verified November 6, 2026. Listings are informational. The evidence score measures public, verifiable evidence and is not an endorsement or a compatibility claim.