IFC MCP server

IFC MCP

IFC MCP lets your AI assistant inspect IFC/BIM files, create IFC files, create reports, open IFC models in a viewer, and apply BCF viewpoints.

How It Works

After installation, ask your AI client in normal language. The AI client starts IFC MCP when it needs the IFC tools and sends your request to the local server. IFC MCP reads IFC files locally, runs the needed IFC logic in a local Pyodide runtime with IfcOpenShell, and returns the answer to the chat.

Good example prompts:

• Open examples/sample.ifc and summarize the model.
• Count the walls, doors, windows, spaces, and property sets in examples/sample.ifc.
• Find missing names, classifications, and suspicious property values in this IFC file.
• Create a CSV room-area report from this IFC file.
• Create a simple IFC file with one building, one storey, and four walls.
• Open the IFC viewer and show examples/sample.ifc.
• Apply C:\path\to\viewpoint.bcfzip in the open IFC viewer.
• Clear the IFC viewer.

If IFC MCP creates a report, BCF file, or new IFC file, it returns a local download link. If you ask to view a model, IFC MCP opens a local viewer link. If your AI client does not open that link automatically, open it in your browser.

Large IFC files can take more than a minute to process. Cancelling a request does not stop Python already running; wait for it to finish before trying again.

Installation

1. Prerequisites

Install Node.js 20 or newer from the official Node.js download page. Choose the LTS version for your operating system, run the installer, then reopen the app where you want to use IFC MCP.

IFC MCP uses npx, which is included with Node.js. If your app later says node or npx is not found, reinstall Node.js LTS and reopen the app.

2. Choose your client

ChatGPT desktop app

ChatGPT desktop supports local MCP servers over STDIO.

1. Open the ChatGPT desktop app.
2. Open Settings.
3. Select Plugins, then MCPs.
4. Click Add. If prompted for a server type, choose STDIO.
5. Enter:

• Name: ifc-mcp
• Command to launch: npx
• First argument: -y
• Second argument: ifc-mcp

1. Leave the environment variable fields empty and save the server.
2. Restart the ChatGPT desktop app.
3. Start a new chat, type /mcp, and confirm that ifc-mcp is connected.

For more detail, see OpenAI's MCP documentation.

Claude Desktop

Option 1: Use the Claude Desktop UI

Desktop MCP config file.

1. Open Claude Desktop.
2. Open Settings.
3. Open Developer or Desktop app developer settings.
4. Click Edit Config if that button is available. This opens the Claude

Desktop.

1. Paste the JSON below, save the file, then fully quit and reopen Claude

{
  "mcpServers": {
    "ifc-mcp": {
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

If the file already contains JSON, add only the ifc-mcp entry inside the existing mcpServers object. Do not create a second mcpServers object.

Option 2: Open the config file directly

Use this only if you do not see Edit Config in Claude Desktop:

• Windows: %APPDATA%\Claude\claudedesktopconfig.json
• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json

Paste the same JSON from Option 1, save the file, then fully quit and reopen Claude Desktop.

Check

To check the setup, open Claude Desktop, start a new chat, click the + button near the chat box, and look for Connectors. IFC MCP should appear there after Claude Desktop has restarted. You should see the tools listed in the How It Works section above.

Shortened. The full README is on GitHub.