Skip to content
Back to search

freecad-mcp

FreeCAD MCP(Model Context Protocol) server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/neka-nat/freecad-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/neka-nat/freecad-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/neka-nat--freecad-mcp/badge.svg)](/listings/neka-nat--freecad-mcp)

HTML

<a href="/listings/neka-nat--freecad-mcp"><img src="/api/listings/neka-nat--freecad-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need FreeCAD and [uv / uvx](https://docs.astral.sh/uv/guides/tools/). 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](docs/installation.md#addon-directory), then restart FreeCAD. Select the **MCP Addon** workbench and click **Start RPC Server** in the **FreeCAD MCP** toolbar.

See the [installation guide](docs/installation.md) 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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 85 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # FreeCAD MCP
  2. <!-- mcp-name: io.github.neka-nat/freecad-mcp -->
  3. <p align="left">
  4. <a href="https://www.star-history.com/neka-nat/freecad-mcp">
  5. <picture>
  6. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=neka-nat/freecad-mcp&type=trending&theme=dark" />
  7. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=neka-nat/freecad-mcp&type=trending" />
  8. <img alt="GitHub Trending Repository of the Day" src="https://api.star-history.com/badge?repo=neka-nat/freecad-mcp&type=trending" />
  9. </picture>
  10. </a>
  11. </p>
  12. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/neka-nat-freecad-mcp-badge.png)](https://mseep.ai/app/neka-nat-freecad-mcp)
  13. Control FreeCAD from Claude Desktop and other MCP clients. Create and edit models,
  14. run Python scripts, inspect documents, and run FEM analyses.
  15. ## Demo
  16. Design a flange:
  17. ![Designing a flange in FreeCAD](./assets/freecad_mcp4.gif)
  18. See [more demos and examples](docs/examples.md) for a toy car, modelling from a
  19. 2D drawing, and agent integrations.
  20. ## Quick start
  21. You need FreeCAD and [uv / uvx](https://docs.astral.sh/uv/guides/tools/).
  22. FreeCAD MCP has two components: an addon running inside FreeCAD and an MCP server
  23. launched by your client.
  24. ### 1. Install and start the FreeCAD addon
  25. ```bash
  26. git clone https://github.com/neka-nat/freecad-mcp.git
  27. cd freecad-mcp
  28. ```
  29. Copy `addon/FreeCADMCP` into your [FreeCAD addon directory](docs/installation.md#addon-directory),
  30. then restart FreeCAD. Select the **MCP Addon** workbench and click
  31. **Start RPC Server** in the **FreeCAD MCP** toolbar.
  32. See the [installation guide](docs/installation.md) for platform-specific commands
  33. and screenshots.
  34. ### 2. Connect Claude Desktop
  35. Add the following entry to `claude_desktop_config.json`:
  36. ```json
  37. {
  38. "mcpServers": {
  39. "freecad": {
  40. "command": "uvx",
  41. "args": ["freecad-mcp"]
  42. }
  43. }
  44. }
  45. ```
  46. Restart Claude Desktop to load the configuration, keep FreeCAD open with its RPC
  47. server running, and ask Claude to create a model. Connections use `localhost` by
  48. default.
  49. ## Documentation
  50. | Guide | Contents |
  51. | --- | --- |
  52. | [Installation](docs/installation.md) | Addon directories, setup screenshots, running from source |
  53. | [Configuration](docs/configuration.md) | Auto-start, text feedback, remote connections, HTTP transport |
  54. | [Docker](docs/docker.md) | Running the MCP server in a container, client setup, networking |
  55. | [Tools](docs/tools.md) | Available tools, screenshots, FEM analysis |
  56. | [Code execution](docs/execution.md) | GUI execution, background jobs, headless scripts, timeout troubleshooting |
  57. | [Demos and examples](docs/examples.md) | Design demos, FEM example, ADK and LangChain integrations |
  58. ## Contributors
  59. <a href="https://github.com/neka-nat/freecad-mcp/graphs/contributors">
  60. <img src="https://contrib.rocks/image?repo=neka-nat/freecad-mcp" />
  61. </a>
  62. Made with [contrib.rocks](https://contrib.rocks).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.