Skip to main content
Glama
archicad-tapir-mcp

archicad-tapir-mcp

by joacos

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

  1. Archicad 25 a 30 (Windows o macOS) con un proyecto abierto.

  2. Add-on Tapir instalado: descargá el instalador para Windows o para macOS y reiniciá Archicad.

  3. 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-mcp

El 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

archicad_status

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.

archicad_model_summary

Resumen del proyecto en una llamada: pisos, cantidad de elementos por tipo, piso y capa, superficie de zonas y selección actual.

archicad_list_elements

Lista compacta de elementos (guid, tipo, ID, piso, capa), mucho más liviana que GetDetailsOfElements.

archicad_quantities

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.

archicad_check_model

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.

archicad_set_element_ids

Cambia IDs de elementos: valores explícitos, sufijos únicos para IDs repetidos (fixDuplicates) o numeración con prefijo (numbering, por ejemplo FU-001).

archicad_create_room

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 (slabStructure: "default" conserva la estructura de la herramienta Losa). La zona se ubica automáticamente; como Archicad solo lo logra en el piso abierto en pantalla, en otros pisos se dibuja por el contorno interior de los muros.

archicad_undo / archicad_history

Revierte las últimas acciones de las tres tools anteriores (borra lo creado y restaura lo cambiado) y lista lo que se puede revertir.

tapir_list_commands

Lista los comandos de Tapir, filtrando por grupo o texto.

tapir_describe_command

Devuelve el JSON Schema de entrada y salida de un comando.

tapir_run_command

Ejecuta cualquier comando de Tapir, validando los parámetros antes de enviarlos.

archicad_run_api_command

Ejecuta cualquier comando oficial API.*.

30 comandos de Tapir como tools propias

Los más usados (GetSelectedElements, GetElementsByType, GetPropertyValuesOfElements, CreateWalls, CreateSlabs, MoveElements, DeleteElements, etc.), con el schema exacto de Tapir.

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

ARCHICAD_MCP_TOOLS

curated

all expone los ~250 comandos como tools; none deja solo las genéricas.

ARCHICAD_MCP_READ_ONLY

apagado

Con 1, rechaza todo comando que pueda modificar el modelo.

ARCHICAD_PORT

autodetección

Fija el puerto si tenés varios Archicad abiertos.

ARCHICAD_HOST

127.0.0.1

Host de Archicad.

ARCHICAD_TIMEOUT

120

Segundos de espera por comando.

ARCHICAD_MCP_MAX_CHARS

100000

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-automation

Tests

python -m pip install -e ".[test]"
python -m pytest

Los tests levantan un Archicad simulado por HTTP, así que no necesitan Archicad.

Available Tools

53 tools
archicad_check_modelB
Read-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_itemsA
Read-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_imagesB
Read-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_historyA
Read-only

Lists the actions archicad_undo can revert in the open project, newest first.

Inputs: no named parameters.

archicad_list_elementsA
Read-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_summaryA
Read-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_quantitiesA
Read-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_commandC
Destructive

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_statusA
Read-only

Lists the running Archicad instances (port, version) and whether the Tapir add-on answers.

Inputs: no named parameters.

archicad_undoA
Destructive

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.

ChangeSelectionOfElementsC
Destructive

Adds/removes a number of elements to/from the current selection. (Tapir, Element Commands)

Inputs: addElementsToSelection, removeElementsFromSelection.

CreateColumnsC
Destructive

Creates Column elements based on the given parameters. (Tapir, Element Commands)

Inputs: columnsData (required).

CreateIssueC
Destructive

Creates a new issue. (Tapir, Issue Management Commands)

Inputs: name (required), tagText, parentIssueId.

CreateObjectsC
Destructive

Creates Object elements based on the given parameters. (Tapir, Element Commands)

Inputs: objectsData (required).

CreateSlabsC
Destructive

Creates Slab elements based on the given parameters. (Tapir, Element Commands)

Inputs: slabsData (required).

CreateWallsC
Destructive

Creates Wall elements based on the given parameters. (Tapir, Element Commands)

Inputs: wallsData (required).

CreateZonesC
Destructive

Creates Zone elements based on the given parameters. (Tapir, Element Commands)

Inputs: zonesData (required).

DeleteElementsB
Destructive

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).

FilterElementsC
Read-only

Tests an elements by the given criterias. (Tapir, Element Commands)

Inputs: elements (required), filters.

Get3DBoundingBoxesB
Read-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).

GetAllElementsC
Read-only

Returns the identifier of all elements on the plan. Use the optional filter parameter for filtering. (Tapir, Element Commands)

Inputs: filters, databases.

GetAllPropertiesB
Read-only

Returns all user defined and built-in properties. (Tapir, Property Commands)

Inputs: no named parameters.

GetAttributesByTypeC
Read-only

Returns the details of every attribute of the given type. (Tapir, Attribute Commands)

Inputs: attributeType (required).

GetClassificationsOfElementsC
Read-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).

GetDetailsOfElementsA
Read-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.

GetElementsByTypeB
Read-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.

GetGDLParametersOfElementsB
Read-only

Gets all the GDL parameters (name, type, value) of the given elements. (Tapir, Element Commands)

Inputs: elements (required).

GetIssuesB
Read-only

Retrieves information about existing issues. (Tapir, Issue Management Commands)

Inputs: no named parameters.

GetLayersC
Read-only

Returns the details of the given Layer attributes. (Tapir, Attribute Commands)

Inputs: attributeIds (required), fields.

GetNavigatorItemTreeB
Read-only

Returns the full navigator item tree for the specified map. (Tapir, Navigator Commands)

Inputs: navigatorMapId (required), publisherSetName.

GetProjectInfoB
Read-only

Retrieves information about the currently loaded project. (Tapir, Project Commands)

Inputs: no named parameters.

GetPropertyValuesOfElementsB
Read-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).

GetSelectedElementsB
Read-only

Gets the list of the currently selected elements. (Tapir, Element Commands)

Inputs: no named parameters.

GetStoriesB
Read-only

Retrieves information about the story sructure of the currently loaded project. (Tapir, Project Commands)

Inputs: no named parameters.

GetZoneBoundariesA
Read-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.

HighlightElementsB
Destructive

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.

MoveElementsC
Destructive

Moves elements with a given vector. (Tapir, Element Commands)

Inputs: elementsWithMoveVectors (required).

SetClassificationsOfElementsB
Destructive

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).

SetGDLParametersOfElementsC
Destructive

Sets the given GDL parameters of the given elements. (Tapir, Element Commands)

Inputs: elementsWithGDLParameters (required).

SetPropertyValuesOfElementsC
Destructive

Sets the property values of elements. It works for subelements of hierarchal elements also. (Tapir, Property Commands)

Inputs: elementPropertyValues (required).

tapir_describe_commandA
Read-only

Returns the input and output JSON schemas of a Tapir command. Read this before tapir_run_command.

Inputs: command (required).

tapir_list_commandsA
Read-only

Lists Tapir commands with a one-line description, optionally filtered by group name or text.

Inputs: group, search.

tapir_run_commandA
Destructive

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

    C2.8/5.0

    Scored across 53 tools

    Disambiguation3/5

    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.

    Naming Consistency2/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

      https://cotlet.dev/mcp/v1/procore
    • MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.

      https://api.artificialwit.com/mcp
    • 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

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Archicad automation, enabling AI assistants to run Python scripts against running Archicad instances via the Tapir JSON API for complex workflows.
      4
      167 PyPI
      8
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Read-only MCP bridge for Archicad using the Tapir Add-On, enabling discovery, context binding, and safe read operations on Archicad projects.
      8
      -