FreeCAD MCP by staf_37

English · Русский · 简体中文 · Español · हिन्दी · العربية · 日本語

Create CAD models and drawings in your installed FreeCAD, directly from your AI workspace. Connect Codex, Claude Code, Cursor, VS Code or another local MCP client. Maintained by staf_37.

Download applications · Installation · Tools · Troubleshooting · Contributing

Download → open → connect

1. Install FreeCAD with its graphical interface separately.

2. Download the application archive for your operating system from the table below. You do not need the repository, a compiler or a separate Python installation.

3. Extract the entire archive. Open FreeCAD-MCP.app on macOS, FreeCAD-MCP.exe on Windows, or FreeCAD-MCP on Linux.

4. Check the detected FreeCAD path, select your clients and press Connect / Подключить.

5. Restart the selected clients and approve the MCP server if they request trust.

The application copies its runtime into your user directory. After successful setup, the extracted download folder can be moved or removed. Keep the complete folder until setup finishes. If FreeCAD is not detected, select its GUI executable or .app manually.

This repository is private. Downloads require a GitHub account with access. The app interface currently uses Russian and English; the guides are available in seven languages.

Related MCP server: FreeCAD Robust MCP Server

What you can do

Example request to your agent:

In a new FreeCAD document, create a 60 × 40 × 12 mm plate with a central Ø12 mm hole. Make a drawing with front, side and top views. Save FCStd, STEP and PDF in my chosen folder. Preserve existing documents.

Local by design

flowchart LR
    A[AI client] -->|MCP stdio| B[FreeCAD MCP]
    B -->|Authenticated loopback TCP| C[Bridge queue]
    C -->|GUI thread| D[FreeCAD models and drawings]

FreeCAD itself reports the correct profile directory. The installer adds the bridge there and keeps its own components in a stable user directory. With auto-start enabled, FreeCAD opens when the agent first calls a CAD tool. Starting FreeCAD can take longer than starting the MCP server.

The bridge listens only on 127.0.0.1 and requires a random session token. Python commands run with FreeCAD's privileges: this is not a sandbox. Cloud agents without access to your computer cannot directly use this local stdio server. See security.

Clients and platform limits

Codex, Claude Code, Cursor and the default VS Code user profile have automatic configuration. Other local MCP clients can import the generated manual-config.json. Existing configuration is backed up; other servers and custom environment values are preserved. JSONC files and nonstandard client profiles may require the client's own Add Server interface.

Targets: Windows x64, Linux x64, macOS Apple Silicon and Intel. Linux requires a compatible glibc desktop distribution, such as Ubuntu 22.04 or newer. Sandboxed FreeCAD packages, WSL-to-Windows connections, headless FreeCADCmd and mobile operating systems are outside automatic setup support.

Packaged startup/MCP checks are separate from real CAD verification. The complete FreeCAD 1.1.3 CAD workflow has been verified on macOS arm64. See validation and the linked build run for the actual platform checks. Binaries are not commercially signed or notarized; your OS may ask you to approve opening them.

Documentation and development

• Installation, updates, removal and troubleshooting

• Russian installation reference

• Tool reference and CAD examples — Russian

• Architecture — Russian

• Validation record — Russian

• Release and packaging guide

• Contributing · Security

For development, use Python 3.11+ and uv:

uv sync --locked --group build
uv run pytest -q
uv run --group build python scripts/build_app.py

Repository statistics are a snapshot, not a live external counter. Last refresh and values. Maintainers can refresh them with python scripts/update_badges.py using their existing GitHub CLI authentication. No token is embedded in the badges.

Download applications

v0.2.2 — complete application bundles with Python and dependencies included. Download the bundle for your CPU architecture; do not select GitHub's “Source code” archives unless you want to develop the project.

Release notes and all assets · SHA-256 checksums