Skip to content
Back to search

tapir-archicad-MCP

MCP server that exposes all Tapir commands to AI models through autogenerated tools

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/SzamosiMate/tapir-archicad-MCP with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/SzamosiMate/tapir-archicad-MCP'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/szamosimate--tapir-archicad-mcp/badge.svg)](/listings/szamosimate--tapir-archicad-mcp)

HTML

<a href="/listings/szamosimate--tapir-archicad-mcp"><img src="/api/listings/szamosimate--tapir-archicad-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Follow these steps to get the server running and connected to an MCP client like Claude for Desktop.

1. Prerequisites

- **Python 3.12+** and **`uv`**: Ensure you have a modern version of Python and the `uv` package manager installed. - **Archicad & Tapir Add-On**: You must have Archicad running (which includes the official JSON API). To access the full set of community-developed tools, the [Tapir Archicad Add-On](https://github.com/ENZYME-APD/tapir-archicad-automation) must also be installed. - **MCP Client**: An application that can host MCP servers, such as [Claude for Desktop](https://www.claude.ai/download) or [Gemini CLI](https://github.com/google-gemini/gemini-cli).

2. Configure Your AI Client

Open your client's `config.json` file and add the following configuration. This command works across operating systems:

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows:** `%APDATA%\Claude\claude_desktop_config.json`

{
  "mcpServers": {
    "ArchicadTapir": {
      "command": "uvx",
      "args": [
        "--from",
        "tapir-archicad-mcp",
        "archicad-server"
      ]
    }
  }
}

3. One-click install (optional)

If your client supports [MCP Bundles](https://github.com/modelcontextprotocol/mcpb) you can skip the config file above. Claude Desktop, Claude Code and MCP for Windows all install `.mcpb` files.

Download [tapir-archicad.mcpb](https://github.com/SzamosiMate/tapir-archicad-MCP/releases/latest/download/tapir-archicad.mcpb) from the latest release and open it in your client. On the Microsoft Store build of Claude Desktop this is the easier route, because the app does not read the `%APPDATA%\Claude\claude_desktop_config.json` that everyone documents.

`uv` still has to be on the PATH your client sees, but it provisions Python and the locked dependencies itself, so there is nothing else to install. The first launch takes 15 to 30 seconds while it builds that environment. The bundle can modify the open project, export files, and send or receive Teamwork, so treat installing it like handing your client your Archicad seat.

<details> <summary>If the bundle will not start</summary>

- **"Server disconnected", or the install itself fails.** Uninstall the bundle, restart the client, then install it again. Installing over an existing bundle can leave stale state behind that a straight reinstall does not clear. - **Nothing happens for the first half minute.** That is uv building the environment, and antivirus scanning or a slow connection stretches it out. Restart the client once before assuming the bundle is broken. - **Claude Desktop logs** are at `%APPDATA%\Claude\logs\mcp-server-Archicad (Tapir).log`. On the Microsoft Store build that path is redirected and the real file is `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\mcp-server-Archicad (Tapir).log`.

</details>

Icon artwork is the official Tapir mark from [ENZYME-APD/tapir-archicad-automation](https://github.com/ENZYME-APD/tapir-archicad-automation) (`branding/logo/png/tapir_logo_black_512.png`), MIT, Copyright 2024 Enzyme APD.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 91 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Archicad Tapir MCP Server
  2. Connect your AI assistant to Archicad. Use natural language to explore projects and automate workflows through the [Tapir add-on](https://github.com/ENZYME-APD/tapir-archicad-automation) and the official Archicad JSON API.
  3. [![PyPI version](https://img.shields.io/pypi/v/tapir-archicad-mcp)](https://pypi.org/project/tapir-archicad-mcp/)
  4. [![CI](https://github.com/SzamosiMate/tapir-archicad-MCP/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/SzamosiMate/tapir-archicad-MCP/actions/workflows/test.yml)
  5. ![Platforms: Windows and macOS](https://img.shields.io/badge/platforms-Windows%20%7C%20macOS-blue)
  6. [![Supported Tapir version](https://img.shields.io/badge/Tapir_Add--On-2.0.0-blue)](https://github.com/ENZYME-APD/tapir-archicad-automation/releases)
  7. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  8. ## See it in action
  9. Astra uses photos and a plan as references to model in Archicad.
  10. [![Watch the Archicad modeling demo on YouTube](https://img.youtube.com/vi/LuWmoVjfpUA/hqdefault.jpg)](https://www.youtube.com/watch?v=LuWmoVjfpUA)
  11. ## What can it do?
  12. - Inspect open projects, elements, properties, and attributes.
  13. - Create and modify model elements, and work with views and layouts.
  14. - Export project data and use supported IFC and Teamwork commands.
  15. - Access **800+ Archicad commands**, discovered on demand by your assistant.
  16. - Connect to multiple running Archicad instances.
  17. ## Quick start
  18. Before installing the MCP server, make sure Archicad is running on Windows or macOS and install these two requirements:
  19. 1. **[Tapir add-on](https://github.com/ENZYME-APD/tapir-archicad-automation)** — an Archicad add-on that gives the server access to Archicad's automation commands. Install it in Archicad for the version you use.
  20. 2. **[uv](https://docs.astral.sh/uv/getting-started/installation/)** — a tool that installs and runs the MCP server and its dependencies. Install it on the computer running Archicad.
  21. You'll also need an MCP client: the AI application that connects to the server.
  22. ### Ask your AI to install it
  23. Copy this prompt into your AI assistant:
  24. > Install the Archicad Tapir MCP server for my MCP client, following the instructions at https://github.com/SzamosiMate/tapir-archicad-MCP/blob/master/docs/setup-and-configuration.md. Help me verify that it can connect to my running Archicad instance.
  25. ### Install it yourself
  26. If your client supports MCP bundles, download [tapir-archicad.mcpb](https://github.com/SzamosiMate/tapir-archicad-MCP/releases/latest/download/tapir-archicad.mcpb) and open it in your client. The client must be able to find `uv` on its PATH.
  27. Prefer the old-school approach? Follow the [manual setup instructions](docs/setup-and-configuration.md#manual-configuration)—editing a config file is optional hacker cred.
  28. ### Try it
  29. With Archicad running, ask your assistant:
  30. > What Archicad projects do I have open?
  31. The assistant can list ready instances, their project names and ports, and report instances that are unavailable. If you have multiple projects open, specify the port when asking it to work on one.
  32. ## How it works
  33. Your MCP client runs this server, which connects to Archicad through [`multiconn_archicad`](https://github.com/SzamosiMate/multiconn_archicad). The server exposes five MCP tools for finding instances, listing commands, looking up their schemas, executing commands, and checking long-running jobs. Your assistant discovers the Archicad commands it needs instead of loading all their schemas at once.
  34. ## Important to know
  35. The server can create, modify, and delete model elements, export files, and interact with Teamwork. Project names, paths, and model data returned by commands are sent to your MCP client. Review changes made to your projects and use a copy when experimenting.
  36. Available commands depend on your installed Archicad and Tapir versions. Instance discovery reports a missing Tapir add-on as unavailable and warns when the installed Tapir version differs from the version supported by the server.
  37. ## Documentation
  38. See [Setup and configuration](docs/setup-and-configuration.md) for client setup, troubleshooting, server options, HTTP transports, jobs, and pagination.
  39. ## Development and contributing
  40. To develop the server, clone the repository and run `uv sync` from the project directory. Then configure your MCP client to run the Python interpreter from that checkout's virtual environment:
  41. | Client setting | Windows | macOS |
  42. | --- | --- | --- |
  43. | Command | `<project>\.venv\Scripts\python.exe` | `<project>/.venv/bin/python` |
  44. | Arguments | `-m`, `tapir_archicad_mcp.server` | `-m`, `tapir_archicad_mcp.server` |
  45. Replace `<project>` with the absolute path to your checkout. This runs the local code instead of the published `uvx` package. Restart the server in your client after making changes. Run tests with `uv run pytest tests`.
  46. ### Generated commands
  47. The Archicad command wrappers in `src/tapir_archicad_mcp/tools/generated/` are generated from the exact `multiconn-archicad` version pinned in `pyproject.toml`. The generator reads command metadata from that release's Git tag; `scripts/generator_config.py` controls naming, exclusions, pagination, and image handling, and `scripts/generate_tools.py` produces the wrappers. To change generated behavior, review the generator and its configuration rather than only editing the generated files, since regeneration can overwrite those edits.
  48. ### Contributions
  49. Ideas, bug fixes, and small, focused improvements are welcome. For larger features, architectural changes, or major rewrites, please [open an issue](https://github.com/SzamosiMate/tapir-archicad-MCP/issues) to discuss the approach before investing in a pull request. I may prefer to work through those changes myself as part of understanding and shaping the design.
  50. AI-assisted contributions are welcome. Please keep pull request descriptions short and in plain language: explain the problem, your solution, and how you checked it. For larger changes in particular, understand the proposed implementation and be ready to discuss the design and trade-offs.
  51. ## License and acknowledgments
  52. This project is licensed under the [MIT License](LICENSE). The bundle icon uses the Tapir mark from [ENZYME-APD/tapir-archicad-automation](https://github.com/ENZYME-APD/tapir-archicad-automation) (`branding/logo/png/tapir_logo_black_512.png`), MIT, Copyright 2024 Enzyme APD.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.