Reported issues for FreeCAD MCP

Pod holds 6 of 6 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to FreeCAD MCP.

Most discussed

Upstream Dependency Updates Available

FreeCAD

Stable (1.1.x) — installable via conda-forge

Current: v1.1.0
Latest on conda-forge: v1.1.3
Action: bump ARG FREECAD_VERSION=1.1.3 in Dockerfile

Note: Review and test before upgrading. FreeCAD API may change between versions.

Read the thread · 2026-08-10 · closed · outside contributor · 1 comment

macOS: FreeCADCmd and headless_server.py auto-detection misses the documented install locations

Heads-up rather than a bug report — both of these have working escape hatches (FREECAD_MCP_FREECAD_BIN, FREECAD_MCP_MODULE_DIR), so nothing is broken. But on a fresh macOS install that follows AGENT-INSTALL.md exactly, neither auto-detection path finds what it's looking for, and the env vars are documented as "auto-detected" — so an agent doing the install has no particular reason to set them until something fails later.

Both come down to the same thing: the auto-detection candidates don'

Read the thread · 2026-08-10 · closed · external user · 0 comments

macOS: view_control screenshot always exceeds 50KB frame limit (full-screen capture, width/height ignored)

Summary

On macOS, view_control(operation="screenshot") can never succeed on a large display. The macOS branch of take_screenshot captures the entire screen at native resolution and returns it as inline base64, which exceeds the 50 KB MAX_MESSAGE_SIZE frame limit by an order of magnitude. The frame is refused and the result is discarded.

On this machine the payload is 769.6 KB against a 50 KB limit — 15.4× over. No combination of arguments avoids it, because the requested `widt

Read the thread · 2026-08-10 · closed · external user · 0 comments

Upstream Dependency Updates Available

FreeCAD dev-weekly CI pin

Current (integration-tests.yml dev-weekly slot): weekly-2026.07.15
Latest weekly on GitHub: weekly-2026.07.22
Action: bump the tag: under the dev-weekly slot in .github/workflows/integration-tests.yml to weekly-2026.07.22 -- test locally first (a real FreeCAD API/behavior change between weeklies has broken CI-relevant handler code before, e.g. the create_tool ToolBit.from_dict() parameter-format regression fi

Read the thread · 2026-07-27 · closed · outside contributor · 1 comment

Upstream Dependency Updates Available

FreeCAD

Stable (1.1.x)

Current: v1.0.0
Latest: v1.1.1
Action: bump ARG FREECAD_VERSION=1.1.1 in Dockerfile

Python Dependencies

pip==26.1.2
pydantic_core==2.47.0

Note: Review and test before upgrading. FreeCAD API may change between versions.

Read the thread · 2026-06-15 · closed · outside contributor · 1 comment

macOS crash: NSWindow init from non-main thread when creating document via MCP

Description

FreeCAD crashes with SIGABRT on macOS when the MCP server triggers document creation (e.g., via part_operations → box). The crash occurs because NSWindow initialization happens on a background thread (Thread 6), which violates macOS AppKit's strict requirement that all GUI operations occur on the main thread (Thread 0).

Environment

macOS: 26.0 (25A5316i)
Hardware: MacBookPro18,2 (Apple Silicon, ARM64)
FreeCAD: Installed via `/Applications/FreeCAD.ap

Read the thread · 2026-05-19 · closed · external user · 3 comments

Most recent

The remaining reports are on the project's issue tracker.