Skip to main content
Glama

AUTOCADSS MCP

MCP server for AutoCAD automation and headless DXF generation.

Backend

Requires AutoCAD?

Screenshot

File IPC

Yes, a running AutoCAD on Windows with an open drawing

Win32 PrintWindow

ezdxf

No, headless

matplotlib render

AUTOCADSS runs alongside the original autocad-mcp: the package, environment variables, IPC file names and AutoLISP command are all separate.

Install

git clone https://github.com/souhaibsmadi42/AUTOCADSS-MCP.git
cd AUTOCADSS-MCP
uv sync

Related MCP server: autocad-mcp

Connect to Claude Code

claude mcp add -s user AUTOCADSS -e AUTOCADSS_MCP_BACKEND=auto -- C:\path\to\AUTOCADSS-MCP\.venv\Scripts\python.exe -m autocadss_mcp

Restart the client after adding it, then call system(operation="status").

Use with a live AutoCAD

  1. Open AutoCAD and a drawing.

  2. Run APPLOAD and load lisp-code/autocadss_dispatch.lsp. Add it to the Startup Suite to load it automatically.

  3. The command line shows === AUTOCADSS Dispatch loaded ===.

  4. Call system(operation="init") so the server switches to the File IPC backend.

Without a matching AutoCAD window, auto falls back to the headless ezdxf backend.

Tools

Tool

Operations

drawing

create, open, info, save, save_as_dxf, plot_pdf, purge, get_variables, undo, redo

entity

create_line, create_circle, create_polyline, create_rectangle, create_arc, create_ellipse, create_mtext, create_hatch, list, count, get, copy, move, rotate, scale, mirror, offset, array, fillet, chamfer, erase

layer

list, create, set_current, set_properties, freeze, thaw, lock, unlock

block

list, insert, insert_with_attributes, get_attributes, update_attribute, define

annotation

create_text, create_dimension_linear, create_dimension_aligned, create_dimension_angular, create_dimension_radius, create_leader

pid

P&ID operations; symbol insertion needs the CAD Tools Online library at C:\PIDv4-CTO\

view

zoom_extents, zoom_window, get_screenshot

system

status, health, get_backend, runtime, init, execute_lisp

execute_lisp runs arbitrary AutoLISP in your AutoCAD session.

Backend limits

Operation

File IPC (live AutoCAD)

ezdxf (headless)

drawing: plot_pdf, undo, redo

Yes

No

entity: offset, fillet, chamfer

Yes

No

view: zoom_extents, zoom_window

Yes

No

system: execute_lisp

Yes

No

block: define

No

Yes

pid: list_symbols

Yes

Yes

pid: every other operation

Needs pid_tools.lsp, see below

Yes, symbols are drawn as labelled placeholders

P&ID on a live AutoCAD

The dispatcher calls P&ID functions from pid_tools.lsp, which is not included in this repository. Until that file is loaded in AutoCAD, every pid operation except list_symbols returns pid_tools.lsp not loaded. The attributes argument of insert_valve, insert_pump and insert_tank is not applied on this backend.

lisp-code/attribute_tools.lsp is an optional set of helper commands for use at the AutoCAD command line. The server does not need it.

Environment variables

Variable

Default

Description

AUTOCADSS_MCP_BACKEND

auto

auto, file_ipc or ezdxf

AUTOCADSS_MCP_IPC_DIR

C:/temp

IPC file folder. If changed, also change *autocadss-ipc-dir* in autocadss_dispatch.lsp

AUTOCADSS_MCP_IPC_TIMEOUT

10

Seconds to wait for one AutoCAD command (1-300)

AUTOCADSS_MCP_TOOL_TIMEOUT

60

Seconds allowed for one whole tool call

AUTOCADSS_MCP_ONLY_TEXT

false

Disable screenshots

AUTOCADSS_MCP_DEBUG_DETECT_FILE

unset

Path of a file to write backend-detection details to, for troubleshooting

CTO_LIBRARY_PATH

C:/PIDv4-CTO

P&ID symbol library folder. Used by the ezdxf backend only; the AutoLISP files always read C:/PIDv4-CTO/

Changes from autocad-mcp v3.1

  • Fixed a Windows hang where the first tool call never returned: native modules now load before the stdio transport starts.

  • Every tool call has a time limit and returns an error instead of waiting forever.

  • Fixed the dev dependency declaration in pyproject.toml, which stopped uv sync from installing test tools.

  • Added a test that drives the real server over stdio.

  • Renamed everything so both servers can be installed together.

Development

uv sync
uv run pytest tests -q

License

MIT. See LICENSE and NOTICE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for full AutoCAD automation, AutoCAD LT automation, and headless DXF generation. It provides 8 consolidated tools for drawing, entity, layer, block, annotation, P&ID, view, and system operations via MCP stdio transport.
      12
      47
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables automation of AutoCAD LT and headless DXF creation through two backends (File IPC for Windows AutoCAD LT and ezdxf for cross-platform) with tools for drawing, entity, layer, block, annotation, PID, view, and system operations.
      8
      14
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for AutoCAD LT automation and headless DXF generation, exposing tools for drawing, entities, layers, blocks, annotations, P&ID, and view operations via natural language.
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables natural-language control of AutoCAD via file IPC or headless DXF generation, with tools for drawing, entities, layers, blocks, annotations, P&ID, views, and system operations.
      8
      MIT