ArchiBridge MCP lets an AI inspect and change a live Archicad project through Tapir’s local JSON API, with safety controls and visual checks.
List running Archicad instances, versions, open projects, and Tapir availability.
Search Archicad/Tapir commands and read their exact input/output schemas.
Run read-only commands to inspect stories, elements, properties, quantities, attributes, and layouts.
Run modifying commands to create or edit walls, slabs, roofs, doors, windows, zones, MEP routes, and more.
Capture images of the current 3D or 2D Archicad window to check results.
Load skills such as archibridge and archicad-mep-review for working methods.
Enforce read/modify separation and policy modes (readonly, ask, full), with restricted commands refused by default.
Integrates with a locally running Archicad project via Archicad's JSON API and the Tapir add-on, enabling AI clients to read project data such as stories, elements, properties, quantities, attributes, and layouts; modify the model through Tapir commands for walls, slabs, roofs, doors, windows, zones, MEP routes, and more; view 3D/2D images; and use skills for metric-unit workflows, staged builds, visual checks, and read-only MEP review.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ArchiBridge MCP Server List the stories in my open Archicad project and count elements by type."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Talk to your Archicad project. ArchiBridge connects Claude Desktop (free plan included), Claude Code and ChatGPT to the Archicad running on your PC, in one prompt.
It uses Archicad's own local JSON API and the open-source Tapir add-on. ArchiBridge adds the MCP server, the one-prompt install, the safety rules and the skills.
The AI reads your open project: stories, elements, properties, quantities, attributes, layouts.
The AI changes the project through 426 Tapir commands: walls, slabs, roofs, doors, windows, zones, MEP routes and more. Your AI app asks you before each change.
The AI sees the result with pictures of the 3D and 2D windows.
Skills: a working method (metric units, staged builds, visual checks) and a read-only MEP review (open ports, elements outside a system, clashes).
Related MCP server: sketchup-mcp2
Windows 10 or 11, Archicad 25 to 30
Claude Desktop (free or paid), Claude Code, or the ChatGPT app with Codex
MEP commands need Archicad 28 or newer.
Archicad 29.0.0 (build 3000, INT) and Tapir 1.7.3, on Windows 11: install, reading a project, creating walls, plan and 3D pictures, and undo. A single Ctrl+Z undid a whole CreateWalls call.
Other Archicad versions, other languages and the MEP review have not been tested yet.
In Claude Desktop, open the Code tab (or start Claude Code), then paste:
Install ArchiBridge to connect Claude to my Archicad: https://github.com/ayoubmep/archibridge-mcp
Follow INSTALL.md step by step, then tell me what to do next.Claude asks for permission before each command. Windows also asks once, to copy Tapir into Archicad's folder: click Yes.
Open PowerShell (not as administrator) and paste:
irm https://raw.githubusercontent.com/ayoubmep/archibridge-mcp/main/install.ps1 | iexRestart Archicad so it loads Tapir, then open a project.
Quit your AI app completely and open it again. For Claude Desktop: right-click the Claude icon near the clock, then Quit.
Try one of the prompts below.
"Read the archibridge skill, then describe my open Archicad project."
"List the stories and count the elements of each type."
"Create a 10 × 8 m house with 3 m walls on the ground floor, then show me a 3D picture."
"Review my MEP model with the archicad-mep-review skill."
"Select all the doors on this story and tell me their sizes."
Claude / ChatGPT <-> ArchiBridge MCP server <-> Archicad JSON API + Tapir <-> your projectEverything stays on your PC: the server only talks to Archicad on 127.0.0.1. What the AI reads does go to the AI provider, as described below.
Tool | Purpose |
| List running Archicads and open projects |
| Find a command |
| Read a command's exact parameters |
| Run a command that changes nothing |
| Run a command that changes the project |
| See the current window |
| Read a working method |
Reads and modifications are separate tools. Any command ArchiBridge doesn't recognise counts as a modification, so your AI app can ask you first. If you choose "always allow" for archicad_modify, it stops asking.
OpenProject, CloseProject, NewProject, QuitArchicad, TeamworkSend and TeamworkReceive are refused by default.
With several Archicads open, ArchiBridge refuses to guess which one to use.
Set the ARCHIBRIDGE_POLICY environment variable in your MCP config to change this:
Value | Effect |
| Only reads run |
| The default: reads and modifications run, restricted commands are refused |
| Restricted commands run too. Use it only if you accept the risk of lost work |
What the AI reads from your project (names, properties, results, pictures) is sent to the AI provider (Anthropic, OpenAI). Check your project's confidentiality rules before using it on real work, and try it first on a copy.
Run the install command again. It updates everything without duplicating anything.
irm https://raw.githubusercontent.com/ayoubmep/archibridge-mcp/main/uninstall.ps1 | iexTapir stays in Archicad, because other tools can use it.
Problem | Solution |
The AI doesn't see the | Quit the app completely (icon near the clock > Quit) and reopen it. |
"Archicad has no open project" | Open a project. Archicad's API answers only then. |
"needs the Tapir add-on" | Restart Archicad. If it persists, run the installer again and click Yes at the Windows prompt. |
"Several Archicads are ready" | Tell the AI which project to use, or close one Archicad. |
Commands time out | Archicad may be showing a dialog. Close it. |
Something else | Open an issue and attach |
Tapir add-on: Tapir Archicad Automation, by Enzyme APD (MIT license). See THIRD_PARTY_NOTICES.md.
ArchiBridge: MIT license, see LICENSE.
ArchiBridge is an independent project, not affiliated with Graphisoft.
Returns a command's input and output schemas, with the definitions they refer to.
Read this before the first call of any command. Definitions listed in moreDefinitions were left out to keep the answer short: pass one of those names here to read it.
Inputs: name (required), depth.
Returns a working method. Skills: archibridge, archicad-mep-review.
Inputs: name. Returns: result
Lists the running Archicads: port, version, open project, and Tapir add-on version.
Call this first. status is "ready", "no_project" (nothing is open yet) or "busy". When tapir is null, only API.* commands work until the add-on is installed.
Inputs: no named parameters.
Runs a command that changes the project, such as CreateWalls or SetDetailsOfElements.
Send many items in one call instead of many calls. Results list one entry per item, and an item can fail on its own, so read the result. Restricted commands such as QuitArchicad and CloseProject are refused unless the user turned on the full policy.
Inputs: command (required), port, parameters.
Runs a command that does not change the project.
command: a Tapir name such as "GetStories", or a built-in such as "API.GetAllElements". parameters: the command's input object. port: only needed when several Archicads are ready. Also allowed: commands that only move the view, such as ChangeWindow and FitInWindow.
Inputs: command (required), port, parameters.
Finds Archicad commands by words in their name, group or description.
Examples: "wall", "property value", "mep port", "layout". Leave query empty to see the groups. minimumArchicad shows commands that need a newer Archicad.
Inputs: limit, query, access.
Returns a picture of Archicad's current window, so you can check your work.
Works for the 3D window and for 2D windows. Switch window first with ChangeWindow if needed. entire_drawing: in a 2D window, capture the whole drawing, not just the zoom.
Inputs: port, entire_drawing.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool has a clearly distinct role: discovery (instances, search_commands), introspection (command_schema), execution (read vs. modify), visual verification (view_image), and guidance (get_skill). The read/modify split is explicit, and search vs. schema is separated by discovery vs. detail lookup. No two tools appear to do the same thing.
All names share the archicad_ snake_case prefix, but action conventions are mixed: search_commands, view_image, and get_skill use verb_noun form, read and modify are bare verbs, and instances and command_schema are noun phrases. The pattern is still readable but not predictable as a uniform verb_noun convention.
Seven tools is well-scoped for an Archicad command bridge. Each tool covers a necessary part of the workflow: setup/discovery, schema lookup, read execution, modify execution, visual checking, and skill guidance. No tool feels redundant or missing from the count.
The surface covers the full bridge lifecycle: finding Archicad instances, discovering commands, reading schemas, executing non-mutating and mutating commands, visually verifying results, and retrieving procedural skills. There are no obvious dead ends for the stated purpose, and read/modify support batch operations.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Connects AI assistants to QCDatabase.AI for everyday construction quality-control work.
AI Hub for AEC — 50+ 3D formats, clash detection, ACC integration via Autodesk Platform Services.
