Log inSubmit server
Archicad logo

Archicad

Connects MCP clients to a live Archicad 29 project for QA, element editing, creation, and API automation.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Archicad

Pick your client, then add it in one click or paste the config.

No confirmed install command yet

We only publish a config when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Archicad, and we’d rather show nothing than a guess you’d paste into your client.

Open setup steps on GitHub

Overview

Archicad MCP server connects MCP clients to a running Archicad 29 instance on macOS or Windows. It can evaluate an open model against YAML office rules, returning pass/fail results, a score, and failed element GUIDs. The server also exposes tools for querying, editing, and creating elements, including placement and window capture, along with official JSON API and Tapir command access. Use it when an agent needs to inspect or modify a live Archicad project, with care around unsaved work and property reads.

Use cases

  • Run office delivery-readiness rules against an open model
  • Inspect element data and identify failed element GUIDs
  • Create or modify Archicad elements through an MCP client
  • Capture the current Archicad window for agent workflows
  • Publish or run IFC checks with the Tapir add-on

Key features

  • YAML-based delivery-readiness QA
  • Element querying, editing, and creation
  • Placement and window capture
  • Official Archicad JSON API access
  • Tapir command gateway
  • macOS and Windows support for Archicad 29

Tools2

What Archicad lets your agent do. Expand a tool for its parameters.

Self-reported~6 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars7Stargazers on the source repository.
Last commitTodayMost recent push to the default branch.
Tools exposed2Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Archicad works

What Archicad MCP server does

Archicad MCP server links an MCP client with an open project in Archicad 29. The connection targets the live desktop application rather than a standalone project file, so Archicad must be running with a project open.

Its two main areas are delivery-readiness checks and model automation. Delivery checks apply office standards written as YAML rules to the open model. Results include an overall pass or fail outcome, a score, and the GUIDs of elements that failed individual checks. The automation layer includes curated operations for reading, changing, and creating model elements, plus access to the official Archicad JSON API and Tapir commands. The exposed tool set includes placement and capture_window.

How it works

The server communicates with Archicad through its live JSON API. An MCP client sends requests to the server, which forwards supported operations to the open Archicad instance and returns the results to the client. It can run in different modes, including full and verdicts; the latter is suitable when access should focus on read-oriented delivery checks.

Tapir is an optional add-on that extends the available operations. It is recommended for element creation, issue handling, IFC checks, highlighting, publishing, and related commands. The installer can place the pinned Tapir 1.7.2 add-on, and tools that depend on it identify the required add-on when it is unavailable.

Setup and configuration

Archicad 29 is required on macOS or Windows, with a project open. The recommended Claude Desktop installation uses a platform-specific .mcpb extension containing Python and its dependencies, so Python, uv, and an internet connection are not needed at runtime. Manual installation uses the archicad-mcp-server package from PyPI and requires uv.

For Claude Desktop, configure the executable with an absolute path and restart the application after changing its MCP configuration. Claude Code can register the server with the archicad-mcp --mode full command. A rules directory can be supplied through ARCHICAD_MCP_RULES_DIR when YAML office rules are stored outside the default location.

ChatGPT requires the server to run over HTTP on the Archicad machine and be exposed through a public HTTPS tunnel. Its MCP endpoint ends in /mcp. Because the endpoint can control the open model, place authentication or access restrictions in front of the tunnel.

Tools and capabilities

  • Runs YAML-based delivery-readiness rules against the open model.
  • Reports rule status, a score, and failed element GUIDs.
  • Queries, edits, and creates Archicad elements.
  • Provides placement and window-capture operations.
  • Passes requests through to official JSON API and Tapir commands.
  • Supports Tapir-backed creation, issue, IFC, highlighting, and publishing workflows when the add-on is installed.

Limitations and notes

Save the project before asking the server to read properties. Archicad 29 can crash when GetPropertyValuesOfElements is called, even for one property on one element. This risk affects delivery audits, individual rule execution, element-data retrieval, and element-data updates, and unsaved changes may be lost.

The server works against a live Archicad process, so it is not suitable for operating on a closed project. ChatGPT access over a tunnel has no server-issued token; anyone who can reach the endpoint may be able to read properties and, in full mode, edit, delete, or publish model content. Restrict the tunnel and stop the server when it is no longer needed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Archicad

Archicad is an MCP server that connects Claude Desktop, Claude Code, ChatGPT, or another MCP client to a running Archicad 29 project. Its main tools cover delivery-readiness QA, placement, window capture, element querying, editing, and creation, with access to official JSON API and Tapir commands.

Install the Claude Desktop extension by importing the platform-specific `.mcpb` bundle, or install `archicad-mcp-server` from PyPI with uv. Claude Code can register the `archicad-mcp` executable directly. Archicad 29 must be running with a project open.

Run the server with HTTP transport on the Archicad machine, expose it through an HTTPS tunnel, and register the tunnel URL ending in `/mcp` as a ChatGPT custom connector. Restrict access to the tunnel because the endpoint can control the open model.

Tapir is optional for basic operation but required for capabilities such as element creation, issues, IFC checks, highlighting, and publishing. The server can install the pinned Tapir 1.7.2 add-on, and dependent tools indicate when it is missing.

No; save the project first. Archicad 29 may crash when the property-reading API is called, and unsaved work can be lost. The warning applies to property reads used by delivery audits, rule execution, element-data retrieval, and element-data updates.

Related MCP servers

All in Architecture & Design All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewArchicad AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/archicad?style=directory)](https://allmcps.com/mcp/archicad)
HTML Embed
<a href="https://allmcps.com/mcp/archicad"><img src="https://allmcps.com/api/badge/archicad?style=directory" alt="Archicad on AllMCPs" /></a>