FreeCAD MCP Server

Community

Control FreeCAD from Claude Desktop via this MCP server.

How to install ↓ Compare GitHub source repository ↗

Category: Dev Tools #133 of 438
Stars: ★ 2.8k Very popular
Transport: stdio (local process)
Runtime: Python · Prebuilt binary
Credentials: No credential needed
License: MIT
Last commit: 4 days ago
Tools: 11

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.

Strongest · Maintenance 14/20 Weakest · Reliability 8/20

Reliability

8/20

Security and permissions

12/20

Maintenance

14/20

Documentation

13/20

Setup experience

12/20

Why each score

Reliability 8/20: Server defines a range of tools including execute_code, but no tests or CI evidence are present. We cannot verify actual tool behavior, but README shows usage examples and happy path seems plausible. Deduction: lack of tests and CI, error handling details unclear.
Security and permissions 12/20: There is an execute_code tool and remote connection capability, with IP whitelist protection and default localhost binding. No obvious malware or credential leakage. Deduction: execute_code is highly privileged and can run arbitrary code, but requires explicit user action; remote connection is off by default with IP filtering.
Maintenance 14/20: Repository is active with 1680 stars and 35 open issues, and recent commits (based on README for remote connection feature). But no release versions or security response channel info. Deduction: lack of version releases and dependency update records.
Documentation 13/20: README provides detailed installation, configuration, and tool descriptions, including remote connection and screenshot parameters. But lacks troubleshooting and limitation disclosure. Deduction: missing troubleshooting and cost/limitation info.
Setup experience 12/20: Installation steps are clear, supports multiple platforms, and includes Claude Desktop configuration examples. But requires uvx and additional FreeCAD setup. Deduction: manual addon installation and RPC server startup are needed, steps are more involved.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local filesRuns commands or code

Best for

Designers and engineers who want to interact with FreeCAD via Claude Desktop
Developers and hobbyists looking to automate CAD workflows

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

Setup

Before you start

Runtime：Python · Prebuilt binary

Install FreeCAD and uvx.
Copy the addon/FreeCADMCP directory to your FreeCAD addon directory (e.g., ~/.FreeCAD/Mod/ on Linux).
Restart FreeCAD, select 'MCP Addon' from the Workbench list, and click 'Start RPC Server' in the toolbar.
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"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add freecad -- uvx freecad-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After installing the FreeCADMCP addon and starting the RPC server in FreeCAD, the Claude Desktop tool list should show the server's 11 tools (e.g. create_document, get_view, run_fem_analysis); calling get_objects proves the connection works.

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

Things to try

Once connected, you can ask your AI assistant things like:

Design a flange in FreeCAD for me
Build a 3D part from this 2D drawing
Show me a screenshot of the current view
Run a CalculiX FEM analysis on the existing Fem::FemAnalysis and report max stress and displacement

Tools 11

create_document writes

Create a new document in FreeCAD.

create_object writes

Create a new object in FreeCAD.

edit_object writes

Edit an object in FreeCAD.

delete_object destructive

Delete an object in FreeCAD.

execute_code writes

Execute arbitrary Python code in FreeCAD.

insert_part_from_library writes

Insert a part from the parts library.

get_view read-only

Get a screenshot of the active view.

get_objects read-only

Get all objects in a document.

Show 3 more tools

get_object read-only

Get an object in a document.

get_parts_list read-only

Get the list of parts in the parts library.

run_fem_analysis writes

Run the CalculiX solver on an existing Fem::FemAnalysis and return summary results (max von Mises stress, max displacement, node count, working directory).

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 Desktop

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

NPM Sentinel MCP Server 79 · B

AI-powered NPM package analysis MCP server

★ 18 · Tools 19 Compare with this →

MartinLoop MCP Server 79 · B

An independent control layer that gives AI coding agents budgets, brakes, and receipts

★ 410 Compare with this →

GitHub MCP Server 76 · B

GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language

★ 33.5k · Tools 15 Compare with this →

Compare with other MCP servers

Source revision 4751f953636f Data synced 2026-10-12 Read the FMRS scoring method