home / mcp / archicad mcp server

Archicad MCP Server

Provides an Archicad MCP server powered by Tapir, exposing Archicad commands to MCP clients like Claude.

Installation

Add the following to your MCP client configuration file.

Configuration

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

archicad-mcp is a framework that runs an MCP server for Graphisoft Archicad. It uses the Tapir add-on with its JSON commands to let MCP clients interact with Archicad, enabling automated tooling and integrations for Archicad workflows.

How to use

You run the MCP server locally and connect your MCP client to it. The server executes Archicad-related JSON commands through Tapir, exposing tools and endpoints that your client can invoke. Use mentored commands via the Tapir interface to automate Archicad tasks, retrieve data, or trigger actions inside Archicad.

How to install

Prerequisites you need before installation are Python, Node tooling, and the uv tool for managing virtual environments.

Clone the project, set up a virtual environment, and prepare the MCP server with uv. Run the commands below in your terminal.

# Clone the repository
git clone https://github.com/lgradisar/archicad-mcp.git
cd archicad-mcp

# Setup virtual environment
uv sync

Configuration and notes

To run the MCP server with Claude or another MCP client, add a configuration entry that points to the local server you start with uv. The following is the MCP configuration snippet you would place in your Claude config to reach the local server.

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

Notes on installation flow

The server is driven by the uv tool to initialize a Python-based MCP server located in the archicad-mcp/src directory. Ensure the path you provide in the directory argument exists, and that the src directory contains the server entry point that uv will execute.

Available tools

Tapir JSON Commands

Defines the JSON command surface exposed by the Tapir add-on, enabling MCP clients to call Archicad functions through standard commands.

Custom Tools

Allows adding user-defined tools beyond the official JSON commands, stored in src/mcp_server/tools/custom_tools.py.