Skip to main content
MCP server CX Codex

Archicad — Claude Code MCP server: what it does, how to install

Connects AI assistants to an active Archicad 29 project to audit office delivery standards and manipulate BIM elements via JSON API.

MIT ★ 12 updated 2026-10-23

Open on GitHub

What Archicad does

This server bridges AI tools to a live Archicad 29 window on macOS or Windows. It runs QA checks against office guidelines defined in YAML files, returning scores alongside specific GUIDs for failing elements. It also opens full access to official JSON API endpoints and Tapir commands.

Reading BIM parameters triggers an unhandled crash in Archicad 29 during GetPropertyValuesOfElements calls. The crash destroys unsaved progress. Always instruct the model to invoke save_project before running audits or reading element properties.

While base queries work out of the box, generating elements or validating IFC setups requires the pinned Tapir 1.7.2 add-on. Setup relies on uv to install the package under the name archicad-mcp-server.

What it helps with

  • Validate an active Archicad 29 model against custom YAML office standards
  • Extract GUID lists for BIM elements failing compliance checks
  • Generate and update project elements using Tapir endpoints
  • Execute project-saving routines before querying CAD property values

Example prompts for the agent

  • Run delivery QA on the active Archicad model using the office rules directory
  • Call save_project first, then fetch GUIDs for all walls missing fire ratings
  • Install the Tapir add-on using archicad-mcp install-tapir to enable element creation

How to install Archicad

Install

The MCP registry has no launch command for it: see the repository README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Archicad

How to install Archicad in Claude Code?

You need the uv tool on your path. Run uv tool install archicad-mcp-server, then register it with claude mcp add archicad -- archicad-mcp --mode full.

What does the Archicad MCP server do?

It interfaces directly with an active Archicad 29 instance on your machine. It handles automated model quality audits and element manipulation through official JSON APIs and Tapir.

Why is saving the project mandatory before reading properties?

Archicad 29 suffers from an internal bug in GetPropertyValuesOfElements that can shut down the CAD app instantly. Running save_project protects your project against data loss.

Similar MCP servers

All MCP servers for Design →

Project sponsors

Companies that keep this analytics open