archicad-tapir-mcp
Connect an MCP client to a running Archicad instance to inspect, query, modify, and automate the model through Tapir and the official JSON API.
Discover running Archicad instances and verify Tapir availability with
archicad_status.Get a one-call project overview, compact element lists, quantity take-offs, and model quality checks.
Return element preview images (3D/2D/section) and zone floor-plan clips.
Change element IDs, classify elements, create rooms/slabs/meshes/surface morphs, move/rotate elements, and adjust slab levels or mesh geometry.
Undo recent changes or list undoable actions via
archicad_undoandarchicad_history.List, describe, and run any Tapir command, with schema validation before execution.
Run arbitrary official
API.*commands against Archicad.Use ~30 common Tapir commands exposed as native tools, plus generic access to the full Tapir command set.
Support
dryRunon modifying tools, read-only mode, and a persistent journal for reverting changes.
Enables control of a running Archicad project through Graphisoft's official JSON API and the Tapir add-on's ~250 commands: inspecting the model (summaries, element lists, quantities, quality checks), creating and modifying elements such as walls, slabs and rooms, managing element IDs, running arbitrary Tapir or API.* commands, and undoing recorded changes.
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., "@archicad-tapir-mcp ¿Qué elementos tengo seleccionados ahora en Archicad?"
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.
archicad-tapir-mcp
Servidor MCP que permite a Claude (u otro cliente MCP) trabajar con un Archicad abierto, usando la API JSON oficial de Graphisoft y los ~780 comandos del add-on Tapir.
Requisitos
Archicad 25 a 30 (Windows o macOS) con un proyecto abierto.
Add-on Tapir instalado: descargá el instalador para Windows o para macOS y reiniciá Archicad.
Python 3.10 o superior.
Related MCP server: archicad-mcp
Instalación
Desde la carpeta de este proyecto:
python -m pip install .Instalación como plugin de Claude
En Claude Code, sin instalar nada a mano (requiere uv):
/plugin marketplace add joacos/archicad-mcp
/plugin install archicad-tapir@archicad-mcpEl plugin arranca el servidor con uvx desde este repositorio. Si ya lo registraste a mano como archicad, quitá esa entrada para no tenerlo duplicado.
Configuración en Claude Desktop
Editá claude_desktop_config.json (Configuración > Desarrollador > Editar configuración) y agregá:
{
"mcpServers": {
"archicad": {
"command": "python",
"args": ["-m", "archicad_mcp"]
}
}
}En macOS el comando suele ser python3, o la ruta del entorno virtual donde lo instalaste (por ejemplo /ruta/al/proyecto/.venv/bin/python). En Windows, si python no está en el PATH, usá la ruta completa, por ejemplo "C:\\Users\\TuUsuario\\AppData\\Local\\Programs\\Python\\Python312\\python.exe".
En Claude Code: claude mcp add archicad -- python -m archicad_mcp.
Reiniciá Claude y pedile, por ejemplo: "¿Qué elementos tengo seleccionados en Archicad?" o "Creá cuatro muros de 3 m de alto formando un rectángulo de 5 × 4 m". Si algo no anda, pedile que ejecute archicad_status.
Herramientas que expone
Tool | Qué hace |
| Busca los Archicad abiertos (puertos 19723-19744), verifica que Tapir responda y avisa qué comandos necesitan una versión más nueva del add-on. |
| Resumen del proyecto en una llamada: pisos, cantidad de elementos por tipo, piso y capa, superficie de zonas y selección actual. |
| Lista compacta de elementos (guid, tipo, ID, piso, capa), mucho más liviana que |
| Cómputo métrico con las propiedades de Archicad: largos, superficies, volúmenes y cantidades, por tipo y opcionalmente por piso o capa, en JSON o CSV. |
| Chequeos de calidad: IDs vacíos o repetidos, elementos sin clasificar, elementos probablemente duplicados, capas ocultas o bloqueadas, zonas sin superficie, pisos sin nombre o vacíos. |
| Cambia IDs de elementos: valores explícitos, sufijos únicos para IDs repetidos ( |
| Crea una habitación desde un contorno: muros sobre cada lado, losa de piso y zona. La losa se crea básica con el espesor pedido ( |
| Revierte las últimas acciones de las tres tools anteriores (borra lo creado y restaura lo cambiado) y lista lo que se puede revertir. |
| Lista los comandos de Tapir, filtrando por grupo o texto. |
| Devuelve el JSON Schema de entrada y salida de un comando. |
| Ejecuta cualquier comando de Tapir, validando los parámetros antes de enviarlos. |
| Ejecuta cualquier comando oficial |
30 comandos de Tapir como tools propias | Los más usados ( |
Cada tool va marcada como de solo lectura o destructiva, para que el cliente pida confirmación donde corresponde.
Las tools que modifican el modelo aceptan dryRun: true para mostrar qué harían sin tocar nada. Archicad no permite agrupar varias acciones en un solo Cmd+Z, así que cada cambio queda registrado en ~/.archicad-mcp/journal.json (configurable con ARCHICAD_MCP_JOURNAL) y archicad_undo lo revierte, aunque se haya reiniciado Claude. Cada registro guarda el proyecto al que pertenece, así que solo se revierte en el proyecto correcto.
Las cuatro tools archicad_model_summary, archicad_list_elements, archicad_quantities y archicad_check_model solo leen el modelo, así que también están disponibles en modo solo lectura. Al conectarse, el servidor lee la versión instalada de Tapir y oculta los comandos que esa versión todavía no tiene.
Opciones (variables de entorno)
Variable | Valor por defecto | Uso |
|
|
|
| apagado | Con |
| autodetección | Fija el puerto si tenés varios Archicad abiertos. |
|
| Host de Archicad. |
|
| Segundos de espera por comando. |
|
| Largo máximo de cada respuesta; lo que exceda se recorta. |
Ejemplo en Claude Desktop:
"archicad": {
"command": "python",
"args": ["-m", "archicad_mcp"],
"env": { "ARCHICAD_MCP_READ_ONLY": "1" }
}Actualizar el catálogo de Tapir
Los schemas vienen de la documentación de Tapir (versión 2.0.0). Cuando salga una versión nueva:
git clone --depth 1 https://github.com/ENZYME-APD/tapir-archicad-automation
python scripts/build_catalog.py tapir-archicad-automationTests
python -m pip install -e ".[test]"
python -m pytestLos tests levantan un Archicad simulado por HTTP, así que no necesitan Archicad.
Available Tools
53 toolsarchicad_check_modelBRead-only
Model quality checks: missing or duplicate IDs, unclassified elements, probable duplicate elements, elements on hidden or locked layers, zones without area, unnamed or empty stories.
Inputs: checks, elements, elementType, maxPerCheck, +1 more.
archicad_classification_itemsARead-only
Lists the items of a classification system with their path, to use in archicad_classify_elements.
Inputs: search, system.
archicad_classify_elementsA
Classifies many elements at once with rules by element type and/or layer (e.g. every Slab on layer '02 PLAZA - Pasto' as 'Terrain'), by default only those still unclassified. Revert with archicad_undo.
Inputs: rules (required), dryRun, system, elements, +3 more.
archicad_create_meshesA
Creates terrain Meshes with heights per point (surveyed ground, paths, curbs), as solid bodies, optionally on a named layer. Revert with archicad_undo.
Inputs: meshes (required), layer, level, dryRun, +2 more.
archicad_create_roomA
Creates a room from an outline: walls along its edges, a floor slab and a zone, on one story. Revert with archicad_undo.
Inputs: polygon (required), slab, walls, dryRun, +7 more.
archicad_create_slabsA
Creates many homogeneous slabs at once (site blocks, platforms, masses) with an exact top level and thickness, optionally on a named layer. Revert with archicad_undo.
Inputs: slabs (required), layer, dryRun, topLevel, +2 more.
archicad_create_surface_morphA
Creates a Morph surface from triangles (e.g. a path draped on terrain) with its own building material, so it reads differently from the mesh below. Revert with archicad_undo.
Inputs: vertices (required), faces, layer, solid, +3 more.
archicad_element_imagesBRead-only
Returns images of elements so you can see them: a 3D, 2D or section preview of each element, and a floor plan clip of each zone. Defaults to the selection when no scope is given.
Inputs: size, limit, elements, imageType, +2 more.
archicad_historyARead-only
Lists the actions archicad_undo can revert in the open project, newest first.
Inputs: no named parameters.
archicad_list_elementsARead-only
Compact list of elements (guid, type, ID, story name, layer name). Much smaller than GetDetailsOfElements; use it to find elements before acting on them.
Inputs: limit, elements, elementType, selectedOnly.
archicad_model_summaryARead-only
One-call overview of the open project: project info, stories, element counts by type, story and layer, zone areas and the current selection. Start here to understand a model.
Inputs: no named parameters.
archicad_move_elementsA
Moves elements (explicit list, selection or a type) by a vector in meters. Revert with archicad_undo.
Inputs: vector (required), dryRun, elements, elementType, +1 more.
archicad_quantitiesARead-only
Quantity take-off from Archicad's built-in properties: lengths (m), areas (m²), volumes (m³) and counts, totalled by element type and optionally by story or layer, as JSON or CSV.
Inputs: format, groupBy, elements, elementType, +2 more.
archicad_rotate_elementsA
Rotates elements in plan around a point by an angle in degrees. Revert with archicad_undo.
Inputs: origin (required), degrees (required), dryRun, elements, +2 more.
archicad_run_api_commandCDestructive
Runs an official Archicad JSON API command, e.g. 'API.GetElementsByType' or 'API.GetBuiltInPropertyIds'. See Graphisoft's JSON API reference for parameters.
Inputs: command (required), parameters.
archicad_set_element_idsA
Changes element IDs: explicit values, unique suffixes for repeated IDs (fixDuplicates) or a prefix + number sequence (numbering). Revert with archicad_undo.
Inputs: ids, dryRun, elements, numbering, +3 more.
archicad_set_meshA
Changes a Mesh (terrain): its level, skirt depth and holes. Works on locked layers and checks the result in 3D. Revert with archicad_undo.
Inputs: guid (required), holes, level, dryRun, +3 more.
archicad_set_slab_levelsA
Changes the top level and/or thickness of slabs (e.g. the height of site masses), verifying the result in 3D. Revert with archicad_undo.
Inputs: layer, dryRun, elements, topLevel, +4 more.
archicad_statusARead-only
Lists the running Archicad instances (port, version) and whether the Tapir add-on answers.
Inputs: no named parameters.
archicad_undoADestructive
Reverts the last actions made with archicad_set_element_ids, archicad_classify_elements, archicad_create_slabs, archicad_create_meshes, archicad_move_elements, archicad_rotate_elements, archicad_set_slab_levels, archicad_set_mesh, archicad_create_surface_morph or archicad_create_room in the open project: deletes what they created and restores what they changed.
Inputs: steps.
ChangeSelectionOfElementsCDestructive
Adds/removes a number of elements to/from the current selection. (Tapir, Element Commands)
Inputs: addElementsToSelection, removeElementsFromSelection.
CreateColumnsCDestructive
Creates Column elements based on the given parameters. (Tapir, Element Commands)
Inputs: columnsData (required).
CreateIssueCDestructive
Creates a new issue. (Tapir, Issue Management Commands)
Inputs: name (required), tagText, parentIssueId.
CreateObjectsCDestructive
Creates Object elements based on the given parameters. (Tapir, Element Commands)
Inputs: objectsData (required).
CreateSlabsCDestructive
Creates Slab elements based on the given parameters. (Tapir, Element Commands)
Inputs: slabsData (required).
CreateWallsCDestructive
Creates Wall elements based on the given parameters. (Tapir, Element Commands)
Inputs: wallsData (required).
CreateZonesCDestructive
Creates Zone elements based on the given parameters. (Tapir, Element Commands)
Inputs: zonesData (required).
DeleteElementsBDestructive
Deletes elements. Returns an execution result for each input element: an element that could not be deleted (for example because its layer is locked) gets a failed execution result instead of being skipped silently. (Tapir, Element Commands)
Inputs: elements (required).
FilterElementsCRead-only
Tests an elements by the given criterias. (Tapir, Element Commands)
Inputs: elements (required), filters.
Get3DBoundingBoxesBRead-only
Get the 3D bounding box of elements. The bounding box is calculated from the global origin in the 3D view. The output is the array of the bounding boxes respective to the input array of elements. (Tapir, Element Commands)
Inputs: elements (required).
GetAllElementsCRead-only
Returns the identifier of all elements on the plan. Use the optional filter parameter for filtering. (Tapir, Element Commands)
Inputs: filters, databases.
GetAllPropertiesBRead-only
Returns all user defined and built-in properties. (Tapir, Property Commands)
Inputs: no named parameters.
GetAttributesByTypeCRead-only
Returns the details of every attribute of the given type. (Tapir, Attribute Commands)
Inputs: attributeType (required).
GetClassificationsOfElementsCRead-only
Returns the classification of the given elements in the given classification systems. It works for subelements of hierarchal elements also. (Tapir, Classification Commands)
Inputs: elements (required), classificationSystemIds (required).
GetDetailsOfElementsARead-only
Gets the details of the given elements (geometry parameters etc). Use the optional fields parameter to return only the fields you need and skip the computation of the others (for example floorPlanPolygons). (Tapir, Element Commands)
Inputs: elements (required), fields.
GetElementsByTypeBRead-only
Returns the identifier of every element of the given type on the plan. It works for any type. Use the optional filter parameter for filtering. (Tapir, Element Commands)
Inputs: elementType (required), filters, databases.
GetGDLParametersOfElementsBRead-only
Gets all the GDL parameters (name, type, value) of the given elements. (Tapir, Element Commands)
Inputs: elements (required).
GetIssuesBRead-only
Retrieves information about existing issues. (Tapir, Issue Management Commands)
Inputs: no named parameters.
GetLayersCRead-only
Returns the details of the given Layer attributes. (Tapir, Attribute Commands)
Inputs: attributeIds (required), fields.
GetProjectInfoBRead-only
Retrieves information about the currently loaded project. (Tapir, Project Commands)
Inputs: no named parameters.
GetPropertyValuesOfElementsBRead-only
Returns the property values of the elements for the given property. It works for subelements of hierarchal elements also. (Tapir, Property Commands)
Inputs: elements (required), properties (required).
GetSelectedElementsBRead-only
Gets the list of the currently selected elements. (Tapir, Element Commands)
Inputs: no named parameters.
GetStoriesBRead-only
Retrieves information about the story sructure of the currently loaded project. (Tapir, Project Commands)
Inputs: no named parameters.
GetZoneBoundariesARead-only
Gets the boundaries of the given Zones (connected elements, neighbour zones, etc.). Accepts either a single zoneElementId or a list of zones. Prefer the list: the expensive boundary recalculation runs once per call, so querying many Zones in one call is much faster than calling the command once per Zone. (Tapir, Element Commands)
Inputs: zones, zoneElementId.
HighlightElementsBDestructive
Highlights the elements given in the elements array. In case of empty elements array removes all previously set highlights. (Tapir, Element Commands)
Inputs: elements (required), highlightedColors (required), wireframe3D, nonHighlightedColor.
MoveElementsCDestructive
Moves elements with a given vector. (Tapir, Element Commands)
Inputs: elementsWithMoveVectors (required).
SetClassificationsOfElementsBDestructive
Sets the classifications of elements. In order to set the classification of an element to unclassified, omit the classificationItemId field. It works for subelements of hierarchal elements also. (Tapir, Classification Commands)
Inputs: elementClassifications (required).
SetGDLParametersOfElementsCDestructive
Sets the given GDL parameters of the given elements. (Tapir, Element Commands)
Inputs: elementsWithGDLParameters (required).
SetPropertyValuesOfElementsCDestructive
Sets the property values of elements. It works for subelements of hierarchal elements also. (Tapir, Property Commands)
Inputs: elementPropertyValues (required).
tapir_describe_commandARead-only
Returns the input and output JSON schemas of a Tapir command. Read this before tapir_run_command.
Inputs: command (required).
tapir_list_commandsARead-only
Lists Tapir commands with a one-line description, optionally filtered by group name or text.
Inputs: group, search.
tapir_run_commandADestructive
Runs any Tapir command. The parameters are validated against the command's input schema (see tapir_describe_command). May modify or delete model data depending on the command.
Inputs: command (required), parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 53 tools
Several tools overlap in purpose (e.g., archicad_list_elements vs GetElementsByType/GetAllElements, archicad_create_slabs vs CreateSlabs, archicad_move_elements vs MoveElements, archicad_classify_elements vs SetClassificationsOfElements). Descriptions distinguish high-level safe/undoable helpers from raw Tapir commands, but with 53 tools an agent can still easily misselect.
Mixed naming conventions: PascalCase Tapir wrappers (GetSelectedElements, CreateWalls) alongside snake_case archicad_* and tapir_* tools. The split signals different layers but is inconsistent from a naming standpoint.
53 tools far exceeds the typical 3-15 range and includes both high-level and low-level duplicates for the same operations. Even for a complex BIM API, this volume is excessive for an MCP server and burdens tool selection.
Core operations for querying, creating, modifying, and deleting Archicad elements are covered, with generic tapir_run_command and archicad_run_api_command providing an escape hatch for missing commands. Dedicated tools for many element types (roofs, windows, beams) are absent, but the generic commands mitigate that gap.
Related MCP Connectors
Buildertrend MCP server for ChatGPT, Claude and any AI agent: get schedule, create daily log, create change order and list selections in your own Buildertrend account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Buildertrend yourself; Cotlet does not store your password and you need no Buildertrend API key. About the official Buildertrend API: Buildertrend publishes no API docs or self-serve keys for customers; it connects through its Marketplace integrations (checked 11 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/buildertrend-api-mcp-server
Procore MCP server for ChatGPT, Claude and any AI agent: list RFIs, create RFI, list submittals, create punch list item, create observation and add manpower entry in your own Procore account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Procore yourself; Cotlet does not store your password and you need no Procore API key. About the official Procore API: Procore has a REST API with OAuth 2.0 and a sandbox, but publishes no MCP server for your own AI agent (checked 5 Nov 2026). The API runs through an app that you register in the Developer Portal and a company admin installs. Setup and FAQ: https://cotlet.dev/integrations/procore-api-mcp-server
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Houzz Pro MCP server for ChatGPT, Claude and any AI agent: list leads, create project, create estimate, send invoice and update lead status in your own Houzz Pro account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Houzz Pro yourself; Cotlet does not store your password and you need no Houzz Pro API key. About the official Houzz Pro API: Houzz Pro has no public API for leads, projects, estimates or invoices (checked 11 Oct 2026). Its only connection for this data is the Zapier app, which offers two actions, Create Lead and Create Project, and no triggers. Setup and FAQ: https://cotlet.dev/integrations/houzz-pro-api-mcp-server
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients like Claude to interact with Graphisoft Archicad through the Tapir add-on's JSON commands. Supports automated Archicad operations and custom tool integration for architectural design workflows.39MIT
- AlicenseAqualityBmaintenanceMCP server for Archicad automation, enabling AI assistants to run Python scripts against running Archicad instances via the Tapir JSON API for complex workflows.4167 PyPI8MIT
- AlicenseAqualityAmaintenanceA bridge allowing AI agents to control Archicad projects via dynamically generated tools from the Tapir and official Archicad JSON APIs.52,834 PyPI139MIT
- FlicenseAqualityBmaintenanceRead-only MCP bridge for Archicad using the Tapir Add-On, enabling discovery, context binding, and safe read operations on Archicad projects.8-