Skip to main content
Glama
autocad-mcp

autocad-mcp

by ajaquin8

autocad-mcp

An MCP server that lets Claude drive the AutoCAD session already running on your PC (tested on 2026 and 2027). It attaches over COM (GetActiveObject on the newest AutoCAD.Application.<release> that is running), so there is no add-in to install and no AutoCAD restart. It follows the design of inventor-mcp (the author's Autodesk Inventor server, not public yet): one COM thread, an edit guard, a busy guard and one undo step per tool.

Notes, decisions and test reports live in the Obsidian vault knowledge/. Working rules for Claude are in CLAUDE.md.

Install (AutoCAD users)

Windows with full AutoCAD or a vertical (not AutoCAD LT, not Mac). No git, Python or venv needed. In the Claude desktop app (Chat and Cowork), install the .mcpb bundle from the Releases page. For Claude Code, install uv and run

claude mcp add autocad --scope user -- uvx --from https://github.com/ajaquin8/autocad-mcp/archive/refs/heads/main.zip autocad-mcp

Step by step, with the safety summary: INSTALL.md.

Related MCP server: vn-autocad-claude

Development setup

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .[dev]

Claude Code picks up .mcp.json (server name autocad) when it is started from this folder; it runs .venv\Scripts\python.exe -m autocad_mcp relative to the project, so it works wherever the repository is cloned. Start AutoCAD first, then ask Claude to call acad_status.

Build the Claude desktop bundle with python scripts/build_mcpb.py (writes dist/autocad-mcp-<version>.mcpb).

Safety

  • Edit guard: only drawings created through the server (new_drawing) are editable. An existing drawing must be unlocked with allow_edit_document, which happens only when you ask.

  • Busy guard: edits are refused while you are in a command, prompt or dialog (CMDACTIVE).

  • One undo step per tool (UNDO Begin/End marks). If a tool fails, what it created is deleted and what it changed is put back.

  • No silent overwrites or discarded changes. close_document only closes the server's own drawings.

  • send_command (raw command line, which bypasses the guard) is registered only with AUTOCAD_MCP_ENABLE_COMMANDS=1.

Details: knowledge/Decisions/Edit guard and document safety.md.

Tools

32 tools: drawings, layers, lines/polylines/arcs/circles/text, dimensions, blocks and attributes, moving/re-layering/deleting by handle, queries, view capture and PDF plotting. The full list is generated from the code into knowledge/Projects/AutoCAD-MCP/Tool reference.md. Coordinates are drawing units in WCS; angles are degrees.

Checks

.\scripts\check.ps1

This runs ruff, the offline pytest suite (no AutoCAD needed), the tool-reference freshness check, the vault link check and a stdio handshake. Live tests go in tests/live/ and run only by hand, after you agree (see knowledge/Decisions/Live test protocol.md).

Status

See knowledge/Projects/AutoCAD-MCP/index.md. In short (2026-11-03): drawing, layers, dimensions, view capture and PDF plotting are verified against live AutoCAD 2027 and 2026; on 2026 also blocks and attributes, edits by handle, open/close, one Ctrl+Z per tool, and edits being refused while you are in a command or dialog.

Contributing

Bug reports, "works on my AutoCAD" reports and pull requests are welcome; see CONTRIBUTING.md. Please never attach drawings or company files.

Credits

The design follows inventor-mcp. AutoCAD COM patterns (late-bound dispatch, VARIANT points, PrintWindow capture, foreground PDF plotting) were learned from U-C4N/Autocad-MCP (MIT). See THIRD_PARTY_NOTICES.md.

Licence: MIT.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables users to control AutoCAD, GstarCAD, or ZWCAD through natural language via Claude Desktop. It provides tools for drawing geometric shapes, adding text and dimensions, and managing CAD files using the Windows COM interface.
    5
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables Claude to control AutoCAD—draw, edit, query, layers, blocks, annotations, screenshots, plot to PDF—using plain language.
    8
    10
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude Web to control a local AutoCAD instance via MCP, exposing 149 tools for CAD operations with dual COM/ezdxf backend support.
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    Connects Claude Desktop to a running AutoCAD instance over local Windows COM, letting users query, draw, edit, organize layers, measure areas, take off quantities, and export sheets to PDF using plain language. Every action is undoable, logged, and optionally restricted to read-only mode with no network exposure.
    MIT