Best for
- Designers and engineers who want to interact with FreeCAD via Claude Desktop
- Developers and hobbyists looking to automate CAD workflows
F
FreeCAD MCP Server
Community
Control FreeCAD from Claude Desktop via this MCP server.
GitHub source repository ↗
59FMRS · C
The FreeCAD MCP server offers extensive CAD control capabilities for Claude Desktop, including modeling, editing, code execution, and FEM analysis. It requires manual setup of the FreeCAD addon and starting the RPC server. Security should be considered due to arbitrary code execution. Overall, it is a powerful tool for automating CAD tasks.
FreeCAD MCP is a Model Context Protocol (MCP) server that lets you control FreeCAD from Claude Desktop. It provides a FreeCAD addon to start an RPC server, and MCP tools for creating and editing objects, executing Python code, inserting parts from the parts library, taking view screenshots, and running finite element analyses (using CalculiX). The server supports remote connections and allows per-call control of screenshot feedback.
Tools
create_document
Create a new document in FreeCAD.
create_object
Create a new object in FreeCAD.
edit_object
Edit an object in FreeCAD.
delete_object
Delete an object in FreeCAD.
execute_code
Execute arbitrary Python code in FreeCAD.
insert_part_from_library
Insert a part from the parts library.
get_view
Get a screenshot of the active view.
get_objects
Get all objects in a document.
get_object
Get an object in a document.
get_parts_list
Get the list of parts in the parts library.
run_fem_analysis
Run the CalculiX solver on an existing Fem::FemAnalysis and return summary results (max von Mises stress, max displacement, node count, working directory).
Setup
- Install FreeCAD and uvx. 2. Copy the addon/FreeCADMCP directory to your FreeCAD addon directory (e.g., ~/.FreeCAD/Mod/ on Linux). 3. Restart FreeCAD, select 'MCP Addon' from the Workbench list, and click 'Start RPC Server' in the toolbar. 4. Add the MCP server configuration to Claude Desktop's config file as shown above.
claude_desktop_config.json
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}
Fit and risk
Not for
- Teams requiring real-time collaboration
- Environments that demand absolute control over CAD precision
- Users who prefer not to install a FreeCAD plugin
Required permissions
- Requires running FreeCAD and the RPC server locally or remotely
- Needs file system access to read/write FreeCAD documents and plugins
- Allows executing arbitrary Python code, so use with caution
Risks and side effects
- Malicious prompts could lead to arbitrary code execution, posing security risks
- Remote connections may expose unauthorized access; configure allowed IPs or CIDR subnets
- Tools may produce many screenshots, increasing bandwidth and storage usage
Troubleshooting
- Ensure FreeCAD is installed and the RPC server is started correctly
- Check the command path in the Claude Desktop configuration
- If remote connection fails, verify the host IP and firewall settings
- For addon issues, confirm the addon directory path and restart FreeCAD
Use cases
Parametric modeling via natural language instructions
Automating repetitive CAD tasks
Generating 3D parts from 2D drawings
Running finite element analysis and retrieving results
Supported clients
Claude DesktopFull support