Repository avatar
Developer Tools
v1.1.1
active

archicad-mcp

io.github.alesdev88/archicad-mcp

Delivery-readiness QA and full official + Tapir API access for a running Archicad 29.

Documentation

Archicad MCP

Connects Claude, ChatGPT or any MCP client to a running Archicad 29 (30 works too) on macOS and Windows. You ask in plain language; the server does it through Archicad's JSON API and the Tapir add-on.

  • Check a model against office standards. YAML rules run against the open model: pass or fail, a score, and the failing elements, highlighted or turned into issues.
  • Find, read and change elements. Criteria queries, properties, classifications, GDL and IFC data, favourites, attributes, clash checks.
  • Create elements. Walls, slabs, columns, doors and windows, zones, stairs, dimensions and 40-odd more types.
  • Everything else. About 800 official and Tapir commands through one gateway.

[!WARNING] Save before reading properties. Archicad 29 can crash on a property read, even of one element, taking unsaved work with it. The server cannot prevent it. Ask the client to run save_project first, and see Known issues.

Install

Claude Desktop: download the bundle for your platform from the latest release and drag it into Settings > Extensions. It carries its own Python, so there is nothing else to install.

PlatformFile
Windowsarchicad-mcp-1.1.1-win32.mcpb
macOS (Apple silicon)archicad-mcp-1.1.1-darwin-arm64.mcpb

To update, ask Claude to update the extension: it downloads the newest release, checks it and opens Claude Desktop's install dialog.

Claude Code (needs uv):

uv tool install archicad-mcp-server
claude mcp add archicad -- archicad-mcp --mode full

Tapir: most tools need the Tapir add-on in Archicad. Ask the client to install Tapir, or run archicad-mcp install-tapir. It puts the pinned Tapir 2.0.0 into Archicad's Add-Ons folder, checked by sha256, and never replaces an existing one unless told to. Restart Archicad afterwards.

Intel Macs, a hand-written Claude Desktop config, ChatGPT, Codex and all the settings: Install.

Check it works

With Archicad open, ask the client to list Archicad instances. It shows the port, Archicad version, open project and Tapir version, and what to install when something is missing. If the client shows no tools at all, see Check it works.

What you can ask

AreaTools
QAaudit_delivery_readiness, run_rule, list_rules, verify_ifc_export_readiness, highlight_failures, create_issues_from_failures
Find and readfind_elements, search_definitions, get_element_data, get_model_summary, get_project_info, list_attributes, find_collisions
Changeset_element_data, modify_elements, apply_favorites, move_elements, delete_elements, edit_attributes, edit_property_definitions, edit_classifications
Createcreate_elements (51 types), create_swept_beam, create_road_marking, create_road_arrow, and learn_library_part for placing furniture, doors and windows from a sketch
Lookshow_elements, capture_window, the selection tools
Issues and outputIssue Manager and BCF, export_ifc, publish, save_project
Teamworkreserve_elements, release_elements
Schedulesread_schedule_scheme, edit_schedule_scheme, validate_schedule_scheme, through Scheme Settings' XML (Archicad has no schedule API)
Library partsmesh models (OBJ, 3DS) to GDL objects: build_gdl_object, deploy_gdl_object
Gatewaylist_api_commands, describe_api_command, execute_read_api_command, execute_write_api_command

Every tool in detail, with what it checks and what it needs: Tools.

Safe by default. Changes to elements, data and definitions are a dry run first, showing current and new values. Delete and move also need confirm=true. Elements Archicad would refuse (another view's, a hidden or locked layer, a hotlinked module, not reserved in Teamwork) are skipped with the reason, never unlocked. A commit reads back what it wrote and reports what did not land.

Office rules

Rules are YAML files in a folder you point the server at (the extension's Office rules folder setting, or ARCHICAD_MCP_RULES_DIR):

- id: walls-fire-rating
  type: property-required
  property: "OFFICE/Fire Rating"
  applies_to: { element_type: Wall }
  severity: error

Eight rule types are built in, and custom checks go in Python beside the YAML. Keep real office standards outside this repository. See Writing rules.

Docs

Privacy

The server runs on your machine and talks only to Archicad on 127.0.0.1. There is no telemetry and no backend. What it reads goes to the MCP client that asked, normally Claude, under that client's privacy terms. See PRIVACY.md.

License

MIT. See LICENSE.

MCPB
https://github.com/alesdev88/Archicad-MCP/releases/download/v1.1.1/archicad-mcp-1.1.1-win32.mcpb
Install Command
# mcpb: https://github.com/alesdev88/Archicad-MCP/releases/download/v1.1.1/archicad-mcp-1.1.1-win32.mcpb
MCPB
https://github.com/alesdev88/Archicad-MCP/releases/download/v1.1.1/archicad-mcp-1.1.1-darwin-arm64.mcpb
Install Command
# mcpb: https://github.com/alesdev88/Archicad-MCP/releases/download/v1.1.1/archicad-mcp-1.1.1-darwin-arm64.mcpb