For AI agents — MCPBundles Directory API
For MCP client apps (human connect):
MCP connect URL: https://mcp.mcpbundles.com/bundle/freecad
Skill page: https://www.mcpbundles.com/skills/freecad
Tools: 22
Live probe refreshed Nov 12, 2026 · Endpoint host mcp.mcpbundles.com
What you can do with FreeCAD
Built for
Makers, Product Designers, Mechanical Engineers, 3D Printing
MCPBundles publishes this directory for MCP discovery. Except where we host or operate an offering, third-party services run under their own terms. Product and company names on this page are used in a descriptive, identifying way (including under nominative fair use where applicable); they remain the property of their owners. Nothing here grants you rights in those marks, and nothing here is an offer to sell a third party's services. Terms
FreeCAD
Add to your AI client, then sign in once when you connect.
Describe a part in chat and have an AI agent build it in FreeCAD on your computer — export STL or STEP for 3D printing, then pull the mesh back into the conversation.
This listing identifies a third-party integration. MCPBundles is not affiliated with, sponsored by, or endorsed by the service or its operator unless stated on this page.
Best forMakersProduct DesignersMechanical Engineers3D Printing
Model a simple L-bracket in FreeCAD with two mounting holes, export STEP, and summarize what you built.
Context to know first
What is FreeCAD MCP?
FreeCAD MCP connects AI agents in Claude, Cursor, ChatGPT, or MCPBundles Studio to FreeCAD on your computer. You describe the part; the agent creates documents, adds solids, edits dimensions, and exports meshes — while FreeCAD stays on your machine.
Can AI export STL files for 3D printing?
Yes. Ask the agent to export STL or STEP to a folder on your computer (for example your Documents folder). You can open the mesh in your slicer the same way you would after modeling by hand.
Does this run FreeCAD in the cloud?
No. Models are built on your computer in FreeCAD. MCPBundles Desktop forwards agent requests to the app on localhost — your geometry never leaves your machine unless you export and share the file yourself.
Related editorial
FreeCAD Parametric CAD Workflows with AI
Model parts on your computer, export STL or STEP for 3D printing, and pull meshes back into chat through MCPBundles Desktop.
How Desktop connects cloud AI to apps on your Mac or PC — the same local bridge pattern FreeCAD uses.
AI Skill
SKILL.md
Domain knowledge for FreeCAD — workflow patterns, data models, and gotchas for your AI agent.
FreeCAD (local)
FreeCAD is open-source parametric CAD. MCPBundles reaches it on the user's machine through MCPBundles Desktop — the same pattern as ComfyUI or Obsidian. The user does not install a separate local MCP server; Desktop owns the localhost bridge into FreeCAD.
Runtime requirements
FreeCAD installed and open on the user's machine while agents work.
MCPBundles Desktop running on the same machine (forwards tool calls to localhost).
Modeling runs on the user's CPU/GPU; heavy boolean ops can take minutes.
Document and object model
Documents hold a scene graph. FreeCAD sanitises names (My Part → My_Part, duplicates get numeric suffixes). Always use document_name / object_name returned by create tools in follow-up calls — never assume the requested label survived unchanged.
doc.recompute() runs after edits; create/edit/delete tools recompute automatically, but custom execute_code may need an explicit recompute.
Recommended workflow (3D print)
Ping / status — confirm FreeCAD is reachable through Desktop before building geometry.
Create document — capture the actual document_name from the response.
Create primitives or generic objects — boxes/cylinders/spheres or Part:: types with property dicts.
Inspect — list or get objects when names or dimensions are uncertain.
Export STL or STEP to an absolute path on the user's disk (for example ~/Documents/exports/part.stl).
Read exported file when the agent needs bytes or a spillover download link for slicing review.
Parts library
When available in the user's FreeCAD install, list the parts library and insert standard components (fasteners, bearings) by relative library path.
Screenshots
Optional isometric PNG captures help visual review. Some workbench views (TechDraw, Spreadsheet) cannot screenshot — the tool returns a clear null/error instead of failing silently.
Gotchas
GUI thread: Modeling dispatches to FreeCAD's GUI thread. Very heavy OCCT booleans may time out — use async code execution and poll object state for long jobs.
Desktop app: Expect the FreeCAD GUI application, not a headless freecadcmd-only workflow.
Export paths: Use absolute paths on the user's machine. Optional allowed file roots on the connection restrict which directories Desktop may read.
Name drift: Treat every create response's document_name / object_name as authoritative.
No cloud fallback: If Desktop or FreeCAD is down, fix the local setup — do not substitute another CAD service.
Create a Part::Box primitive in a FreeCAD document with Length, Width, and Height. Convenience wrapper around freecad_create_object for common 3D-print bases.
Freecad Create Box — Create a Part::Box primitive in a FreeCAD document with Length, Width, and Height. Convenience wrapper around freecad_create_object for common 3D-print bases.
Freecad Create Cylinder — Create a Part::Cylinder with Radius and Height in a FreeCAD document.
Freecad Create Document — Create a new FreeCAD document. Returns the actual document_name assigned by FreeCAD (sanitised and de-duplicated). Use that name in all follow-up object and export calls.
Freecad Create Object — Create a typed object in a FreeCAD document. Pass object_type (Part::Box, Part::Cylinder, Part::Sphere, …) and optional object_properties. Returns the actual object_name FreeCAD assigned.
Freecad Create Sphere — Create a Part::Sphere with Radius in a FreeCAD document.
Freecad Delete Object — Remove an object from a FreeCAD document and recompute the document.
Freecad Edit Object — Update properties on an existing FreeCAD object (dimensions, placement, color, etc.). Pass only the properties that should change.
Freecad Execute Code — Run Python inside FreeCAD on the GUI thread and wait for completion. Use for custom modeling scripts. For long OCCT booleans prefer freecad_execute_code_async.
Freecad Execute Code Async — Start Python in a FreeCAD background thread without blocking until completion. Poll object state with freecad_get_object after heavy fuse/cut/loft operations.
Freecad Export Step — Export a FreeCAD object to STEP on the user's disk. Optionally fetch_file to return file bytes or spillover in the same call.
Frequently Asked Questions
What is FreeCAD MCP?
FreeCAD MCP connects AI agents in Claude, Cursor, ChatGPT, or MCPBundles Studio to FreeCAD on your computer. You describe the part; the agent creates documents, adds solids, edits dimensions, and exports meshes — while FreeCAD stays on your machine.
Can AI export STL files for 3D printing?
Yes. Ask the agent to export STL or STEP to a folder on your computer (for example your Documents folder). You can open the mesh in your slicer the same way you would after modeling by hand.
Freecad Export Stl — Export a FreeCAD object to STL on the user's disk for 3D printing slicers. Optionally fetch_file to return bytes or a spillover download link in the same call.
Freecad Get Object — Fetch one serialized FreeCAD object by document and object name.
Freecad Get Objects — List serialized FreeCAD objects in a document with types and property snapshots. Use to discover object_name values before export or edit.
Freecad Get Screenshot — Capture the active FreeCAD 3D view as a PNG (base64). Returns null when the active view cannot screenshot (TechDraw, Spreadsheet, etc.).
Freecad Get Status — Report FreeCAD MCP RPC and GUI-dispatch health without blocking the GUI thread. Use after ping when create or export calls fail with dispatch timeouts.
Freecad Insert Part From Library — Insert a standard part from the FreeCAD parts library by relative path.
Freecad List Documents — List open FreeCAD document names on the user's machine. Use before get_objects when the active document name is unknown.
Freecad List Parts Library — List entries in the FreeCAD parts library when available in the local install. Use relative paths from this list with freecad_insert_part_from_library.
Freecad Ping — Ping the FreeCAD MCP XML-RPC server on the user's machine. Returns true when FreeCAD is reachable through Desktop. Use first when debugging connection issues.
Freecad Read Local File — Read a file from the user's machine via MCPBundles Desktop after export. Large meshes may return a spillover presigned URL instead of inline base64.
Freecad Reload Document — Close and reopen a saved FreeCAD document from disk to pick up external edits. Fails for unsaved scratch documents with no file on disk.
Freecad Save Document — Save a FreeCAD document to an .FCStd file at an absolute path on the user's machine.
No. Models are built on your computer in FreeCAD. MCPBundles Desktop forwards agent requests to the app on localhost — your geometry never leaves your machine unless you export and share the file yourself.
Do I need a separate MCP server or FreeCAD addon from the web?
No. Install FreeCAD and MCPBundles Desktop, use **Install FreeCAD bridge** in Desktop or the connection test, restart FreeCAD once, and connect the FreeCAD bundle. MCPBundles is the MCP — you do not hunt through Addon Manager for a third-party MCP package.
Which AI apps work with local FreeCAD?
Any MCP client you connect to MCPBundles — including MCPBundles Studio, Cursor, Claude Desktop, and ChatGPT with MCP support. One Desktop app on your Mac or PC holds the connection to FreeCAD.
How do I connect FreeCAD to my AI agent?
Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/freecad. Authentication is handled automatically.
How many tools does FreeCAD provide?
FreeCAD provides 22 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.
What authentication does FreeCAD require?
FreeCAD uses API Key. FreeCAD requires credentials. Connect via MCPBundles and authentication is handled automatically.
MCPBundles is an independent platform built on the open Model Context Protocol standard. MCPBundles is not affiliated with, sponsored by, or endorsed by Anthropic PBC.
More in tools
Other MCP servers in this category from the directory index