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 GitHubWhat 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_projectfirst, then fetch GUIDs for all walls missing fire ratings - Install the Tapir add-on using
archicad-mcp install-tapirto 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.