freecad mcp

by neka-nat

Integrations

  • Allows control of FreeCAD from Claude Desktop, enabling AI agents to interact with and manipulate CAD models and designs programmatically through FreeCAD's functionality.

FreeCAD MCP

This repository is a FreeCAD MCP that allows you to control FreeCAD from Claude Desktop.

Demo

Design a flange

Design a toy car

Design a part from 2D drawing

Input 2D drawing

Demo

This is the conversation history. https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48

Install addon

FreeCAD Addon directory is

  • Windows: %APPDATA%\FreeCAD\Mod\
  • Mac: ~/Library/Application Support/FreeCAD/Mod/
  • Linux: ~/.FreeCAD/Mod/ or ~/snap/freecad/common/Mod/ (if you install FreeCAD from snap)

Please put addon/FreeCADMCP directory to the addon directory.

git clone https://github.com/neka-nat/freecad-mcp.git cd freecad-mcp cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

When you install addon, you need to restart FreeCAD. You can select "MCP Addon" from Workbench list and use it.

And you can start RPC server by "Start RPC Server" command in "FreeCAD MCP" toolbar.

Setting up Claude Desktop

Edit claude_desktop_config.json file.

For user.

{ "mcpServers": { "freecad": { "command": "uvx", "args": [ "freecad-mcp" ] } } }

If you want to save token, you can set only_text_feedback to true and use only text feedback.

{ "mcpServers": { "freecad": { "command": "uvx", "args": [ "freecad-mcp", "--only-text-feedback" ] } } }

For developer. First, you need clone this repository.

git clone https://github.com/neka-nat/freecad-mcp.git
{ "mcpServers": { "freecad": { "command": "uv", "args": [ "--directory", "/path/to/freecad-mcp/", "run", "freecad-mcp" ] } } }

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.

Contributors

Made with contrib.rocks.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

This repository is a FreeCAD MCP that allows you to control FreeCAD from Claude Desktop.

  1. Demo
    1. Design a flange
    2. Design a toy car
    3. Design a part from 2D drawing
  2. Install addon
    1. Setting up Claude Desktop
      1. Tools
        1. Contributors

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            An MCP server that enables Claude Desktop to interact with Sanity.io content, providing tools to create, edit, list documents and get schema templates.
            Last updated -
            TypeScript
          • A
            security
            A
            license
            A
            quality
            Allows Claude desktop app to execute terminal commands and edit files on your computer through MCP, with features including command execution, process management, and diff-based file editing.
            Last updated -
            19
            15,956
            2,540
            JavaScript
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            A FreeCAD addon that implements the Model Context Protocol (MCP) to enable communication between FreeCAD and Claude AI through Claude Desktop.
            Last updated -
            17
            Python
            MIT License
            • Linux
            • Apple
          • -
            security
            A
            license
            -
            quality
            A utility tool that enables Claude Desktop to interact with external tools via the Model Context Protocol, providing features like email sending and simple calculations while simplifying the MCP setup process.
            Last updated -
            129
            9
            JavaScript
            MIT License
            • Apple

          View all related MCP servers

          ID: j3a76r2exh