CAD MCP Server

An MCP server that lets Claude (and any other MCP client) read, analyze, and edit CAD files — both DXF and DWG — powered by ezdxf.

It runs as a small local Python process over stdio. Your CAD files never leave your machine.

• DXF — read and edit directly, no extra setup.

• DWG — Autodesk's proprietary binary format. ezdxf cannot parse it alone, so DWG is converted to DXF automatically via the free ODA File Converter (one-time install). Once installed, DWG works everywhere DXF does.

Quick start (easiest — no clone, no pip)

If you have uv installed, you don't clone anything or manage dependencies — uvx fetches and runs the server for you.

Install uv once:

# Windows (PowerShell):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh

Then add the server in one line:

# Claude Code:
claude mcp add cad -- uvx --from git+https://github.com/Codemod3/cad-mcp cad-mcp

For Claude Desktop, drop this into your config (see paths below) — no clone, no paths to edit:

{
  "mcpServers": {
    "cad": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Codemod3/cad-mcp", "cad-mcp"]
    }
  }
}

That's it. First run downloads deps automatically; later runs are instant. Restart the client and the tools appear. (DWG still needs the free ODA File Converter; DXF works immediately.)

Prefer to clone and manage Python yourself? See Manual install.

Related MCP server: CAKE MCP

What it can do

Read / analyze (never modifies files)

Edit (writes to a copy — your original is never touched)

Editing model — safe by design:

1. Call cad_create_editable_copy on your original → it returns the copy's path.

2. Pass that copy path to every edit tool. Edits save in place and stack, so keep drawing on the same file.

3. Your original is never modified.

4. DWG can't be written directly, so edits always happen on the .dxf copy; run cad_export_dwg at the end if you need a .dwg back.

Requirements

• Python 3.10+ (only for the manual install; uvx handles this for you)

• The Python packages in requirements.txt (installed below)

• DWG only: the free ODA File Converter

Check your Python:

python --version      # must be 3.10 or newer (try python3 on macOS/Linux)

Manual install

Use this if you'd rather clone the repo and manage Python yourself.

1. Get the code

git clone https://github.com/Codemod3/cad-mcp.git
cd cad-mcp

2. Install dependencies

Recommended — use a virtual environment so nothing pollutes your system Python:

python -m venv .venv
# Windows (PowerShell):
.venv\Scripts\Activate.ps1
# macOS / Linux:
source .venv/bin/activate

pip install -r requirements.txt

Or install as a proper command (cad-mcp) via pip:

pip install .

3. Verify it runs

python server.py

It should print a startup line to stderr and then wait silently (it's listening for an MCP client over stdio). Press Ctrl+C to stop. If you see no import errors, you're ready to connect a client.

Connect to a client

Point your MCP client at server.py. Use the full absolute path to the file, and the same Python that has the dependencies installed.

Claude Desktop

Edit the config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cad": {
      "command": "python",
      "args": ["C:\\full\\path\\to\\cad-mcp\\server.py"]
    }
  }
}

On macOS/Linux use "python3" and a /full/path/to/cad-mcp/server.py. If you used a virtualenv, point command at that venv's python, e.g. C:\\path\\to\\cad-mcp\\.venv\\Scripts\\python.exe.

Restart Claude Desktop. The CAD tools appear automatically.

Claude Code (CLI)

Easiest — no clone (needs uv):

claude mcp add cad -- uvx --from git+https://github.com/Codemod3/cad-mcp cad-mcp

If you cloned the repo instead:

claude mcp add cad -- python "C:\full\path\to\cad-mcp\server.py"

Scope (where the server is available):

claude mcp add cad --scope user  -- uvx --from git+https://github.com/Codemod3/cad-mcp cad-mcp   # all your projects
claude mcp add cad --scope project -- uvx --from git+https://github.com/Codemod3/cad-mcp cad-mcp  # writes .mcp.json for teammates

The repo also ships a ready .mcp.json — run Claude Code inside the project folder and the server loads automatically, no command needed.

Verify with /mcp, then just ask Claude to read or edit a CAD file. Remove with claude mcp remove cad.

DWG support

DWG files need the free ODA File Converter installed once:

1. Download for your OS: https://www.opendesign.com/guestfiles/oda_file_converter

2. Install it. Default Windows path: C:\Program Files\ODA\ODAFileConverter <version>\ODAFileConverter.exe

3. Ensure it's on your PATH, or leave it at the default location where ezdxf finds it automatically.

Then use .dwg files exactly like .dxf — conversion is automatic. If the converter is missing, DWG tools return a clear error and DXF keeps working.

Usage examples

Once connected, just talk to Claude:

• "Summarize this DXF file: C:\drawings\floor_plan.dxf"

• "What layers are in site_plan.dwg?"

• "Extract all the text annotations from my drawing."

• "Make an editable copy of plan.dxf, then add a circle radius 5 at (10,10) on a new layer called NOTES."

• "Draw the outline of a 20×10 room as a closed polyline, then export it to DWG."

Supported entity types (read)

LINE, CIRCLE, ARC, LWPOLYLINE, TEXT, MTEXT, INSERT (block refs), DIMENSION, LEADER, ELLIPSE, SPLINE — all other types are still captured with their common attributes (layer, color, handle).

Development

Run the test suite (offline, DXF only — no ODA converter needed):

pip install -r requirements.txt pytest pytest-asyncio
python -m pytest

Troubleshooting

License

MIT — see LICENSE.