blwfish avatar

FreeCAD MCP

blwfish/freecad-mcp

Connects Claude directly to FreeCAD through 30+ tools covering parametric modeling, PartDesign operations, CAM toolpath generation, and mesh manipulation. Runs as a bridge between your AI session and live FreeCAD instances, handling document management, sketch constraints, solid operations, and Report View diagnostics. Supports multiple simultaneous FreeCAD processes with instance switching via UUID or labels. Built for daily production use designing parts and generating CNC toolpaths, not just demos. Requires FreeCAD 1.2-dev for CAM features, 1.1.x for everything else. Includes crash instrumentation and socket-based IPC. The author uses it to debug broken external references, generate parametric macros, and iterate on designs through conversation rather than clicking through menus.

GitHub stars
66
tools
3
transport
STDIO
last updated
Nov 10, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

list_freecad_instancesLists all live FreeCAD instances and their active document info.

Lists all live FreeCAD instances and their active document info.

No parameter schema in public metadata yet.

select_freecad_instanceSelects a FreeCAD instance by uuid or label for subsequent operations.

Selects a FreeCAD instance by uuid or label for subsequent operations.

No parameter schema in public metadata yet.

spawn_freecad_instanceSpawns a new FreeCAD instance (GUI or headless) with an optional label and binary path.

Spawns a new FreeCAD instance (GUI or headless) with an optional label and binary path.

No parameter schema in public metadata yet.

Sponsors

Readme

freecad-mcp

Unit Tests Integration Tests License: LGPL v2.1

What This Does

This is a bridge between your AI agent and FreeCAD — a thinking partner for parametric design, CNC toolpath generation, and mesh work. You bring the design intent and the domain judgment; the agent handles the FreeCAD mechanics. Together: moving faster, co-designing things that would take hours to build by hand, untangling the cryptic error messages that FreeCAD is so good at generating, and hunting down the subtle, knotty modeling problems that are nearly impossible to find alone. Built for personal daily use — designing parts, generating toolpaths, printing and cutting them — not a demo. See TOOLS.md for the full tool reference.

What You Can Work On Together


View the full README on GitHub

Details

Repository
github.com/blwfish/freecad-mcp
Category
Design & Creative
Package
ghcr.io/blwfish/freecad-mcp:latest
Transport
STDIO
Registry
MCP registry, active

Related Design & Creative MCP servers

View all
1arikusi avatarNakkasarikusi/nakkasMCP server that turns AI into an SVG artist. One rendering engine, AI decides everything.31stars
2olgasafonova avatarMiroolgasafonova/miro-mcp-serverControl Miro whiteboards with AI. 110 tools for boards, diagrams, mindmaps, comments, SVG.31stars
3rudraptpsingh avatarFigbridgerudraptpsingh/figbridgeFree, local MCP bridge for Figma — HTML, CSS, Tailwind, tokens, agent handoff bundles.15stars
4fboldo avatarOpenSCADfboldo/openscad-mcp-serverRender STL and PNG from OpenSCAD code.8stars
5dushyant30suthar avatarEndiagram Mcpdushyant30suthar/endiagram-mcpEN Diagram — structural verification for concurrent systems. Pure math, no AI.7stars
6getcutpro avatarCutProgetcutpro/mcpCreate images, videos, music, voices, sound effects and 3D with any AI model, plus AI video clips.0stars