FreeCAD

CommunityPopular

neka-nat

FreeCAD MCP(Model Context Protocol) server

Publisher	neka-nat
Repository	`freecad-mcp`
Language	Python
Forks	299
Stars	2.4K
Available tools	10
Transport type	stdio
Categories	Developer Tools Design
License	MIT
Links	GitHub

Connect tools to AI workflows
FreeCAD exposes MCP capabilities that can be used by compatible AI clients and agents.
10 available tools
Browse the callable actions below, including names and descriptions when provided by the server.
Ready-to-copy setup
Use the installation snippets to configure this server in your preferred MCP client.
Open source signals
2.4K stars and 299 forks from the linked repository.

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:

Designing a flange in FreeCAD

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

bash
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:

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.

Installation

TypingMind

Prerequisites:

Node.js 18+

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

Available Tools

create_document

Create a new document in FreeCAD.

Args:
    name: The name of the document to create.

Returns:
    A message indicating the success or failure of the document creation.

Examples:
    If you want to create a document named "MyDocument", you can use the following data.
    ```json
    {
        "name": "MyDocument"
    }
    ```

create_object
$2e

edit_object

Edit an object in FreeCAD. This tool is used when the create_object tool cannot handle the object creation.

Args:
    doc_name: The name of the document to edit the object in.
    obj_name: The name of the object to edit.
    obj_properties: The properties of the object to edit.

Returns:
    A message indicating the success or failure of the object editing and a screenshot of the object.

delete_object

Delete an object in FreeCAD.

Args:
    doc_name: The name of the document to delete the object from.
    obj_name: The name of the object to delete.

Returns:
    A message indicating the success or failure of the object deletion and a screenshot of the object.

execute_code

Execute arbitrary Python code in FreeCAD.

Args:
    code: The Python code to execute.

Returns:
    A message indicating the success or failure of the code execution, the output of the code execution, and a screenshot of the object.

get_view

Get a screenshot of the active view.

Args:
    view_name: The name of the view to get the screenshot of.
    The following views are available:
    - "Isometric"
    - "Front"
    - "Top"
    - "Right"
    - "Back"
    - "Left"
    - "Bottom"
    - "Dimetric"
    - "Trimetric"

Returns:
    A screenshot of the active view.

insert_part_from_library

Insert a part from the parts library addon.

Args:
    relative_path: The relative path of the part to insert.

Returns:
    A message indicating the success or failure of the part insertion and a screenshot of the object.

get_objects

Get all objects in a document. You can use this tool to get the objects in a document to see what you can check or edit.

Args:
    doc_name: The name of the document to get the objects from.

Returns:
    A list of objects in the document and a screenshot of the document.

get_object

Get an object from a document. You can use this tool to get the properties of an object to see what you can check or edit.

Args:
    doc_name: The name of the document to get the object from.
    obj_name: The name of the object to get.

Returns:
    The object and a screenshot of the object.

get_parts_list
Get the list of parts in the parts library addon.

Use FreeCAD MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once FreeCAD is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

Open TypingMind in your browser.
Click the Settings icon.
Go to Advanced Settings.
Open the Model Context Protocol section.
Click Setup Connector and choose This Device.

TypingMind MCP connector setup screen with This Device selected

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

Copy the setup command shown by TypingMind.
Open Terminal on macOS or Windows Terminal on Windows.
Paste and run the command.
Approve the package install if Terminal asks you to proceed.
Keep the Terminal window running while using MCP tools.

Add FreeCAD as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

Wait until the connector status shows Ready.
Click Edit Servers.
Paste the FreeCAD MCP server configuration.
Save the server list.
Refresh if you want to confirm the connector is still ready.

TypingMind MCP settings showing active server and Edit Servers button

Use it across models

Save the server list, open Plugins, enable the FreeCAD MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

Open the Plugins page in TypingMind.
Enable the FreeCAD MCP tools.
Start a chat and choose the AI model you want to use.
Use the MCP tools in chat or assign them to an AI agent.
Switch to another AI model whenever needed without reconnecting MCP.

TypingMind chat using enabled MCP tools with a selected AI model

Frequently asked questions

What is the FreeCAD MCP server used for?

FreeCAD is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use FreeCAD MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use FreeCAD with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use FreeCAD MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With FreeCAD connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect FreeCAD MCP to TypingMind?

FreeCAD runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does FreeCAD MCP provide in TypingMind?

FreeCAD exposes 10 MCP tools that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use FreeCAD MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If FreeCAD requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all

Chrome DevTools

ChromeDevTools

OrganizationPopular

Chrome DevTools for coding agents

Codebase Memory MCP

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

GitHub

GitHub's official MCP Server

33.1K

0 tools

View details

Invisible Playwright MCP

feder-cr

CommunityPopular

Anti-detect agentic stealth browser: undetected browsing, browser automation, Python AI web browsing agent, computer use, scraping, lead generation. No captchas.

FreeCAD MCP

Demo

Quick start

1. Install and start the FreeCAD addon

2. Connect Claude Desktop

Documentation

Contributors

Installation

Available Tools

Use FreeCAD MCP with multiple AI models

Setup guide to use the local connector

Open the MCP settings

Run the connector command

Add FreeCAD as a server

Use it across models

Frequently asked questions

Related MCP Servers

Set up your own AI workspace now