FreeCAD MCP

FreeCAD MCP(Model Context Protocol) server

Catalog onlyCatalog onlySTDIO

Overview

FreeCAD MCP is a server that allows users to control FreeCAD from Claude Desktop, enabling seamless integration and automation of tasks within FreeCAD.

To use FreeCAD MCP, install the addon in the FreeCAD Addon directory, restart FreeCAD, and select "MCP Addon" from the Workbench list. Start the RPC server using the "Start RPC Server" command in the toolbar.

Control FreeCAD from Claude Desktop - Create and edit documents and objects in FreeCAD - Execute arbitrary Python code within FreeCAD - Access parts from the FreeCAD parts library

Automating the creation of 3D models in FreeCAD.
Integrating FreeCAD with other applications for enhanced workflows.
Developing custom scripts to manipulate FreeCAD objects programmatically.

Add to your AI client

Use these steps to connect FreeCAD MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "freecad-mcp-neka-nat": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-freecad-mcp-neka-nat"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "freecad-mcp-neka-nat": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-freecad-mcp-neka-nat"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "freecad-mcp-neka-nat": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-freecad-mcp-neka-nat"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "freecad-mcp-neka-nat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-freecad-mcp-neka-nat"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "freecad-mcp-neka-nat": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-freecad-mcp-neka-nat"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "freecad-mcp-neka-nat": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-freecad-mcp-neka-nat"
      ]
    }
  }
}

FAQ

Is FreeCAD MCP compatible with all operating systems?

Yes! FreeCAD MCP can be installed on Windows, Mac, and Linux.

Do I need to install FreeCAD separately?

Yes! FreeCAD MCP is an addon that requires FreeCAD to be installed.

Can I use FreeCAD MCP for commercial projects?

Yes! FreeCAD MCP is licensed under the MIT license, allowing for commercial use.

Developer tools