archicad-mcp

`archicad-mcp` is a framework that runs an MCP server for Graphisoft Archicad.

It uses the Tapir add-on with its additional JSON commands to let MCP clients like Anthropic’s Claude interact with Archicad.

Installation

Tapir

For `archicad-mcp` to work, the Tapir Archicad Add-On is required. Please follow the installation instructions provided in that repository.

This package also depends on two Tapir files that define the JSON command structure used to automatically compile MCP-ready tools:

• Tapir Command Definitions file
• Tapir Common Schema Definitions file

These files are located under the `src/mcp_server/tapir` folder.

If you encounter mismatched commands, update the files directly from the Tapir repository.

These files can also be linked directly from the Tapir repo, but may cause mismatches if not updated in sync with the add-on.

FastMCP Server

1. Clone the repository

git clone https://github.com/lgradisar/archicad-mcp.git
cd archicad-mcp

2. Setup virtual environemnt

It is recommended to use `uv` to install and create virutal environment.

Simply run:

uv sync

3. Add to Claude config

Edit the config file manually:

• On Windows: `%APPDATA%\Claude\claude_desktop_config.json`
• On Mac: `~/Library/Application\ Support/Claude/claude_desktop_config.json`

Add this block (replace `YOUR_DIRECTORY` with the full path to archicad-mcp):

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "YOUR_DIRECTORY/archicad-mcp",
        "python",
        "-m",
        "server"
      ],
      "env": {
        "PYTHONPATH": "YOUR_DIRECTORY/archicad-mcp/src"
      }
    }
  }
}

Supported Tools

Tapir JSON Commands

See the full list of Tapir JSON Commands.

Custom Tools

This repository also supports adding your custom tools, either from the official JSON commands or other sources.

They can be defined in the `src/mcp_server/tools/custom_tools.py` file.

For new Archicad-specific commands that are not part of the official JSON commands, it is recommended to contribute them directly to the Tapir repository instead.