archicad-ai
Provides AI-driven tools for interacting with Archicad via Tapir, including project overviews, finding doors missing fire ratings, inspecting door and wall properties, previewing and applying property updates, highlighting elements in the model, measuring walls, and exporting wall cost estimates to Excel.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Archicad AI Productivity Tools
Use plain language to ask an AI to correct fire ratings and estimate wall costs in Archicad.
This software connection, called an MCP server, links Claude (or any MCP client) to Archicad through the free Tapir add-on. Created for the Nemetschek Design AI Productivity Challenge 2027.
▶ Watch the 3-minute demo · Install · One-page summary
What it does
Task | Before | With the AI | |
🚪 | Fire ratings. Find every door with an empty Fire Rating. Check door types and the walls that contain them, then apply a rule to all of them at once. | Open each door's settings, storey by storey | One conversation, 75 s in the demo |
🧱 | Wall cost estimate. Measure every wall by type. Use your rates to produce low / mid / high estimates in Excel. | Manual take-off and spreadsheet work | One request, a few seconds of processing |
On the Villa Patio sample project (3 storeys, 387 walls, 24 doors), finding and checking all 24 doors takes 0.2 s. Applying the ratings takes 0.5 s. Measuring all 387 walls takes 1 s, and pricing them takes 0.6 s. The remaining time is spent in conversation with the AI.
Related MCP server: vn-revit-mcp
How changes are controlled
The software enforces these rules. They do not depend only on instructions given to the AI:
Preview before every change. Tapir's
dryRunchecks proposed changes first. The AI shows old → new values for every door and receives a token that can be used once.Your approval is required. Only
apply_property_update(token)can apply changes. It applies exactly what you previewed. Each token works once.Only property values change. Nothing is created, moved or deleted. You can reverse the whole batch with a single Edit › Undo step.
Wall costing is read-only. It measures walls without editing them.
Names are checked. Before using words such as "fire rating" or "ground floor",
ResolveNameschecks them against the project.
How it works
flowchart LR
U[You] -- plain language --> C[Claude<br/>or any MCP client]
C -- MCP tools --> S[archicad-ai<br/>MCP server]
S -- JSON over HTTP<br/>localhost:19723 --> T[Tapir add-on]
T --> A[Archicad]
S -- Excel --> X[(wall-cost-estimate.xlsx)]Tool | Step | Changes the model? |
| List storeys with door and wall counts | No |
| Check the user's words against names in the project | No |
| Find: list doors with an empty Fire Rating, by storey | No |
| Check: inspect door type and size, plus the host wall's type, thickness and rating | No |
| Highlight elements and zoom to them (red = to fix, green = fixed) | No (display only) |
| Preview: check proposed changes without applying them, show old → new values and return a token | No |
| Fix: apply exactly the previewed changes, then count again | Property values only |
| Measure length, height, net/gross area and volume by wall type | No |
| Calculate low/mid/high costs by wall type and export to Excel with assumptions | No |
Quick start
# 1. Install Tapir in Archicad (Add-On Manager), open a project
# 2. Get the server
git clone https://github.com/vietcad-com/archicad-ai-productivity
cd archicad-ai-productivity && uv sync
# 3. Connect Claude Code
claude mcp add archicad -- uv --directory "$(pwd)" run nemetschek-aiThen ask:
Which doors have no fire rating, per storey? Show them to me in red, check their door types and host walls and propose a rule. Don't change anything yet.
Price every wall by type. 300 mm walls 46 USD/m², 150 mm 28, glass 180/220/260. Net area, ±15 %. Export to Excel.
See INSTALL.md for full setup instructions, including Claude Desktop.
Reproduce the demo
demo/demo.py runs the demo video's four prompts in real Claude Code sessions using the open project. It records the screen with ffmpeg.
Project layout
src/nemetschek_ai/
ac.py Archicad JSON API + Tapir client (port discovery, helpers)
server.py MCP server: tools, safety rules, Excel export
demo/demo.py scripted demo run + screen recording
docs/ one-page summary, demo GIFCredits
Tapir by ENZYME APD and contributors: the Archicad add-on used by these tools.
Model Context Protocol Python SDK.
Villa Patio sample project © Graphisoft / enzyme apd.
Made by VietCAD, a Nemetschek partner in Vietnam. Available under the MIT licence.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read and edit the Revit 2024–2027 model on your PC. Needs the free Revit MCP add-in.
Check floor-plan images, trace them into editable plans, export PDF and IFC, and query IFC models.
Built-environment forecasts, public benchmarks, and permit or zoning readiness through remote MCP.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseAqualityBmaintenanceAn MCP server connecting Claude to a running Archicad 29 instance for delivery-readiness QA via YAML rules and full Archicad API access, including querying, editing, creating elements, and schedule scheme editing.5611MIT
- AlicenseBqualityCmaintenanceEnables Claude and other MCP clients to query an open Autodesk Revit model through pyRevit 7 — counting doors and rooms, taking off wall, slab and structural quantities, detecting missing parameters, and exporting results to Excel. It runs only a fixed set of pre-written scripts (no arbitrary AI-generated code), with 10 of 11 tools strictly read-only.116MIT
- AlicenseAqualityCmaintenanceEnables validating IFC models against IDS requirements with coverage reporting, auditing LOD by project stage, and extracting quantity take-offs, including combined audit summaries and full BIM health checks. It exposes these capabilities as MCP tools for Claude Desktop, producing Excel, HTML, and BCF reports.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to check penetration seals against tested ETA rows, search the ETA database, inspect project penetrations, and export register, BCF, IFC, and assessment documents with citations.MIT