Archicad MCP server

Archicad MCP

An MCP server for Archicad 29 on macOS and Windows. It connects Claude Desktop, Claude Code, ChatGPT, or any MCP client to a running Archicad instance and does two jobs:

run against the open model. Returns pass/fail, a score, and the GUIDs of the elements that failed.

1. Delivery-readiness QA. Your office standards, written as YAML rules and

elements, plus a gateway to every official JSON API and Tapir command.

1. Full API access. Curated tools for querying, editing, and creating

[!WARNING]

Save before you read properties. GetPropertyValuesOfElements can crash

Archicad 29, even for a single property on a single element, taking unsaved

work with it. This is an Archicad-side fault the server can trigger but cannot

prevent. It affects auditdeliveryreadiness, runrule, getelement_data,

and setelementdata. See Known issues before you

point this at a model you care about.

Requirements

Python interpreter and every dependency, so there is nothing to install first and nothing to download on first launch. The manual install paths below do need uv, which fetches a suitable Python (3.12+) for you.

• Archicad 29, running, with a project open. The JSON API talks to the live app.
• Nothing else, if you install the extension. The .mcpb carries its own

optional but recommended. Required for element creation, issues, IFC checks, highlighting, and publishing. The bundled command definitions are synced from Tapir 1.5.8, and the server has been exercised live against 1.5.9, so a newer add-on than the definitions is fine. Without the add-on, those tools degrade instead of erroring.

• Tapir add-on,

Install as a Claude Desktop extension (recommended)

One file, one click, no JSON editing, and no prerequisites. Download the bundle for your platform from the latest release:

There is no Intel macOS bundle. cryptography, which this server depends on through FastMCP, no longer publishes macOS x86_64 wheels, so that bundle could only be produced by compiling on an Intel Mac. Intel Macs use the manual install below instead, where the build happens on the machine that will run it.

Then in Claude Desktop open Settings > Extensions and drag it in.

Mode, office rules folder, and the property-read ceiling then appear as form fields in the extension's settings, and the whole server gets an on/off switch. Leave a field empty and it falls back to the default in the table below.

The bundle contains a complete CPython 3.12 and every dependency, so it starts immediately and works on a machine with no Python, no uv, and no internet access. That is why it is 42 MB on Windows and 54 MB on macOS: the alternative was asking every machine to install a package manager first.

Deploying to a team? On a Team or Enterprise plan an owner can upload the bundle under Organization settings > Connectors > Desktop, which makes it a one-click install for everyone instead of a file to pass around.

If you would rather wire it up by hand, or you are on Claude Code, use one of the sections below instead. Those install the server from PyPI, where it is published as archicad-mcp-server (the plain name was already taken by an unrelated project), so uv tool upgrade archicad-mcp-server moves you to the next release. Each section also shows the wheel URL of the current release, for when you want to pin exactly this version rather than whatever PyPI holds when you run the command.

Install on macOS

Shortened. The full README is on GitHub.