Install FreeCAD MCP Server

Pick your client, copy the command, done.

claude mcp add freecad-mcp-server -- /absolute/path/to/FreeCAD-MCP-Server/.venv/bin/freecad-mcp-agent

Environment Variables

Set these before running FreeCAD MCP Server.

VariableDescriptionRequired

FREECAD_MCP_HOSTThe host address for the FreeCAD TCP server.No

FREECAD_MCP_PORTThe port number for the FreeCAD TCP server.No

FREECAD_MCP_NO_AUTOSTARTSet to 1 to disable the automatic start of the RPC server in FreeCAD.No

Once configured, FreeCAD MCP Server gives your AI agent access to:

list_documentsReturns all open documents with names, file paths, and object counts.

get_document_graphReturns the full feature tree including TypeId, properties, dependency links, and validity state.

inspect_objectProvides a complete property dump for a single object with shape metadata.

analyze_shapePerforms topological analysis including face classifications, edge details, bounding box, and volume.

get_sketch_diagnosticsReturns constraint health, DOF, conflicts, redundancies, and coordinates for geometry elements.

tracked_recomputeRecomputes the document and returns a diff of new, resolved, and persistent errors.

execute_scriptRuns arbitrary Python code inside the FreeCAD instance.

get_screenshotCaptures the 3D viewport as a base64 PNG.

reload_handlersHot-reloads handler code without restarting FreeCAD.

After setup, try these prompts with your AI agent:

→What objects are currently in the active FreeCAD document?

→The Pocket001 feature is failing; can you diagnose the issue using the sketch diagnostics?

→Is Sketch003 fully constrained, or are there any conflicts I should know about?

→Recompute the document and tell me if any new errors were introduced.

→Take a screenshot of the current 3D viewport and analyze the topology of the main object.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Python 3.8+ with pip installed

Save the docs, env vars, and workflow around FreeCAD MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.