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