Freecad MCP Server
FreeCAD geometry design and model generation controlled directly via Claude Desktop.
Data last scanned today · Reviewed today
Overview
The FreeCAD MCP server enables direct control of FreeCAD software from within the Claude Desktop environment. By installing the provided addon and starting the built-in RPC server, users can automate the creation of 3D designs, parts, and mechanical models through natural language prompts. It includes an auto-start feature that persists settings across sessions to streamline repetitive CAD workflows. Installation involves placing the addon files into the platform-specific FreeCAD Mod directory, followed by a configuration update to the Claude Desktop JSON settings. The server supports an optional text-only feedback mode to reduce output verbosity during intensive modeling tasks.
Our verdict
With a security score of 50/100, this server is classified as high-risk. This rating reflects the fact that it is a community-maintained project rather than an official vendor release, and critical aspects such as OAuth and read-only mode have not yet been editorially reviewed. Given the high degree of system control inherent in CAD automation, users should exercise caution and review the source code before deployment in environments containing sensitive intellectual property.
- No direct dependencies reduce supply-chain attack surface
- Active repository with 18 contributors
- Supports persistent auto-start configurations for CAD workflows
- Community-maintained without official vendor oversight
- Security-sensitive features like OAuth remain unreviewed
Tools
| Tool | Description | Risk |
|---|---|---|
| create_document | Create a new document in FreeCAD. | medium |
| create_object | Create a new object in FreeCAD. | medium |
| edit_object | Edit an object in FreeCAD. | medium |
| delete_object | Delete an object in FreeCAD. | high |
| execute_code | Execute arbitrary Python code in FreeCAD. | high |
| insert_part_from_library | Insert a part from the parts library. | medium |
| get_view | Get a screenshot of the active view. | low |
| get_objects | Get all objects in a document. | low |
| get_object | Get an object in a document. | low |
| get_parts_list | Get the list of parts in the parts library. | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What software is required to use this MCP server?
You must have FreeCAD installed and the FreeCAD MCP addon copied to your specific platform's Mod directory. Additionally, the uvx tool from astral.sh is required for the Claude Desktop integration.
›How do I ensure the RPC server is running?
After installing the addon and restarting FreeCAD, you can start the RPC server manually via the 'Start RPC Server' command in the FreeCAD MCP toolbar. You can also enable 'Auto-Start Server' in the MCP Addon workbench menu to have it launch automatically on startup.
›Can I control FreeCAD from a different computer on my network?
Yes, you can enable 'Remote Connections' in the FreeCAD MCP toolbar and define authorized IP addresses or CIDR subnets. You must then pass the --host flag with the target machine's IP address or hostname in your Claude Desktop configuration.
›Is it possible to reduce the amount of visual feedback in Claude Desktop?
Yes, you can configure the MCP server to use text-only feedback by adding the --only-text-feedback flag to the args section in your claude_desktop_config.json file.
Badge
Maintain this server? Add the live badge to your README.