FreeCAD MCP
Control FreeCAD from Claude Desktop and other MCP clients. Create and edit models, run Python scripts, inspect documents, and run FEM analyses.
Demo
Design a flange:
See more demos and examples for a toy car, modelling from a 2D drawing, and agent integrations.
Quick start
You need FreeCAD and uv / uvx. FreeCAD MCP has two components: an addon running inside FreeCAD and an MCP server launched by your client.
1. Install and start the FreeCAD addon
git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp
Copy addon/FreeCADMCP into your FreeCAD addon directory,
then restart FreeCAD. Select the MCP Addon workbench and click
Start RPC Server in the FreeCAD MCP toolbar.
See the installation guide for platform-specific commands and screenshots.
2. Connect Claude Desktop
Add the following entry to claude_desktop_config.json:
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": ["freecad-mcp"]
}
}
}
Restart Claude Desktop to load the configuration, keep FreeCAD open with its RPC
server running, and ask Claude to create a model. Connections use localhost by
default.
Documentation
| Guide | Contents |
|---|---|
| Installation | Addon directories, setup screenshots, running from source |
| Configuration | Auto-start, text feedback, remote connections |
| Tools | Available tools, screenshots, FEM analysis |
| Code execution | GUI execution, background jobs, headless scripts, timeout troubleshooting |
| Demos and examples | Design demos, FEM example, ADK and LangChain integrations |
Contributors
Made with contrib.rocks.
1 maintainer
Metadata
1 maintainer
Release files for freecad-mcp 0.1.28
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| freecad_mcp-0.1.28.tar.gz | 132.2 kB | Without provenance | Details for freecad_mcp-0.1.28.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| freecad_mcp-0.1.28-py3-none-any.whl | Python 3 | none | any | Details for freecad_mcp-0.1.28-py3-none-any.whl |
Total release size: 155.9 kB
Release files / freecad_mcp-0.1.28.tar.gz
| Download URL | freecad_mcp-0.1.28.tar.gz |
|---|---|
| Size | 132.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
06a8fc611220a8a1003cee437e40ec79089878830a2666b9e7c6aa4bc3ee82b1
|
|
BLAKE2b-256 checksum How to use checksums |
58b3239b8bb1c84eaad23fd147520434ebb8f6d0894359c302dc72d68fc36105
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / freecad_mcp-0.1.28-py3-none-any.whl
| Download URL | freecad_mcp-0.1.28-py3-none-any.whl |
|---|---|
| Size | 23.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9912ad05bf2a08888bb208ed080b3402bf9b468ba778c70e18382586aecbabb4
|
|
BLAKE2b-256 checksum How to use checksums |
e4303e61e062b843b29cff614b87397ee85e1300cdca28e9e6d7cbe54bea5a2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for freecad-mcp 0.1.28
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
