IFC MCP

Local IFC/BIM MCP server with IfcOpenShell Python in Pyodide and an IFC viewer.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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.

Installation

1. Prerequisites

Install Node.js 18.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.

Open the ChatGPT desktop app.
Open Settings.
Select Plugins, then MCPs.
Click Add. If prompted for a server type, choose STDIO.
Enter:
- Name: ifc-mcp
- Command to launch: npx
- First argument: -y
- Second argument: ifc-mcp
Leave the environment variable fields empty and save the server.
Restart the ChatGPT desktop app.
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

Open Claude Desktop.
Open Settings.
Open Developer or Desktop app developer settings.
Click Edit Config if that button is available. This opens the Claude Desktop MCP config file.
Paste the JSON below, save the file, then fully quit and reopen Claude Desktop.

config.json

{
  "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\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.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.

For more detail, see Claude's local MCP server guide.

VS Code Copilot

Option 1: Use the install button

This opens VS Code and adds IFC MCP.

If VS Code asks whether you trust the server, accept it. Reload VS Code if the tools do not appear. Open Chat and use the tools/configure-tools button to see the IFC MCP tools.

Option 2: Add .vscode/mcp.json manually

config.json

{
  "servers": {
    "IFC MCP": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

Reload VS Code after saving the file.

Open Chat and use the tools/configure-tools button to see the IFC MCP tools.

For more detail, see the VS Code MCP server docs.

VS Code Codex

Option 1: Use the Codex settings UI

Open VS Code.
Open the Codex panel.
Open Codex settings.
Select MCP servers.
Click Add server.
Enter:
- Name: ifc-mcp
- Command: npx
- Arguments: -y ifc-mcp
Save the server.
Reload VS Code or start a new Codex session.
Check that the IFC MCP tools are available in the new Codex session.

Option 2: Use the terminal command

Open Terminal -> New Terminal in VS Code.
Paste and run:

powershell

codex mcp add ifc-mcp -- npx -y ifc-mcp

Reload VS Code or start a new Codex session.
Check that the IFC MCP tools are available in the new Codex session.

For more detail, see the Codex MCP docs.

VS Code Claude Code

Option 1: Use a project JSON file

Open your project in VS Code.
Create or edit .mcp.json in the project root.
Add this JSON and save the file:

config.json

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

Reopen Claude Code in VS Code.
Type /mcp and approve the project server if Claude asks.
Check that ifc-mcp is connected.

Option 2: Use the terminal command for all projects

Terminal

claude mcp add --transport stdio ifc-mcp --scope user -- npx -y ifc-mcp

Then reopen Claude Code in VS Code, type /mcp, and check that ifc-mcp is connected.

If the claude command is not found, install Claude Code first.

For more detail, see the Claude Code VS Code docs and Claude Code MCP docs.

Other MCP clients

Add this server entry to your MCP client config:

config.json

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

Restart the MCP client after saving the config.

For more detail, see the Model Context Protocol docs.

Use Your Own Viewer

If your app already has an IFC viewer, you can reuse IFC MCP's normal tool interface and apply viewer actions in your app instead of opening the default local viewer. The MCP client still calls tools like show-ifc-file and set-bcf-view; your app only defines what those viewer tools do.

server.ts

import { createServer } from "ifc-mcp";

const server = createServer({
  viewer: {
    "show-ifc-file": async ({ file_path }) => {
      return loadIfcIntoThisViewer(file_path);
    },

    "set-bcf-view": async ({ bcf_path }) => {
      return applyBcfToThisViewer(bcf_path);
    },

    "clear-ifc-viewer": async () => {
      return clearThisViewer();
    },
  },
});

The callback names and argument names match the MCP tool names and schemas, so there is no second naming system to learn.

Local Development

For local development from this checkout:

Terminal

npm install
npm test

The workspace includes .vscode/mcp.json, so VS Code can run the server from this checkout.

Security

IFC MCP keeps the IFC work on your own machine. It reads your IFC files locally, runs the IFC analysis locally, and opens a local viewer. It does not publish the viewer to the public internet.

Generated reports, BCF files, and IFC files are temporary local download links. IFC MCP does not write generated output files into your project folder by default.

Use IFC MCP only with IFC/BIM files and project folders you trust. It can read the files you ask it to use, and incorrect or misleading model data can lead to wrong reports or generated IFC files.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

27d ago

Most recent push to the default branch.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about IFC MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ifc-mcp": { "command": "npx", "args": ["-y", "IFC MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ifc-mcp?style=directory)](https://allmcps.com/mcp/ifc-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/ifc-mcp"><img src="https://allmcps.com/api/badge/ifc-mcp?style=directory" alt="IFC MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

41Quality signal: Fair · 41/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity6/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to IFC MCP →Install in Claude Desktop Install in Cursor Install in VS Code

IFC MCP

Local IFC/BIM MCP server with IfcOpenShell Python in Pyodide and an IFC viewer.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

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.

Installation

1. Prerequisites

Install Node.js 18.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.

Open the ChatGPT desktop app.
Open Settings.
Select Plugins, then MCPs.
Click Add. If prompted for a server type, choose STDIO.
Enter:
- Name: ifc-mcp
- Command to launch: npx
- First argument: -y
- Second argument: ifc-mcp
Leave the environment variable fields empty and save the server.
Restart the ChatGPT desktop app.
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

Open Claude Desktop.
Open Settings.
Open Developer or Desktop app developer settings.
Click Edit Config if that button is available. This opens the Claude Desktop MCP config file.
Paste the JSON below, save the file, then fully quit and reopen Claude Desktop.

config.json

{
  "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\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

Check

For more detail, see Claude's local MCP server guide.

VS Code Copilot

Option 1: Use the install button

This opens VS Code and adds IFC MCP.

If VS Code asks whether you trust the server, accept it. Reload VS Code if the tools do not appear. Open Chat and use the tools/configure-tools button to see the IFC MCP tools.

Option 2: Add .vscode/mcp.json manually

config.json

{
  "servers": {
    "IFC MCP": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

Reload VS Code after saving the file.

Open Chat and use the tools/configure-tools button to see the IFC MCP tools.

For more detail, see the VS Code MCP server docs.

VS Code Codex

Option 1: Use the Codex settings UI

Open VS Code.
Open the Codex panel.
Open Codex settings.
Select MCP servers.
Click Add server.
Enter:
- Name: ifc-mcp
- Command: npx
- Arguments: -y ifc-mcp
Save the server.
Reload VS Code or start a new Codex session.
Check that the IFC MCP tools are available in the new Codex session.

Option 2: Use the terminal command

Open Terminal -> New Terminal in VS Code.
Paste and run:

powershell

codex mcp add ifc-mcp -- npx -y ifc-mcp

Reload VS Code or start a new Codex session.
Check that the IFC MCP tools are available in the new Codex session.

For more detail, see the Codex MCP docs.

VS Code Claude Code

Option 1: Use a project JSON file

Open your project in VS Code.
Create or edit .mcp.json in the project root.
Add this JSON and save the file:

config.json

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

Reopen Claude Code in VS Code.
Type /mcp and approve the project server if Claude asks.
Check that ifc-mcp is connected.

Option 2: Use the terminal command for all projects

Terminal

claude mcp add --transport stdio ifc-mcp --scope user -- npx -y ifc-mcp

Then reopen Claude Code in VS Code, type /mcp, and check that ifc-mcp is connected.

If the claude command is not found, install Claude Code first.

For more detail, see the Claude Code VS Code docs and Claude Code MCP docs.

Other MCP clients

Add this server entry to your MCP client config:

config.json

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

Restart the MCP client after saving the config.

For more detail, see the Model Context Protocol docs.

Use Your Own Viewer

server.ts

import { createServer } from "ifc-mcp";

const server = createServer({
  viewer: {
    "show-ifc-file": async ({ file_path }) => {
      return loadIfcIntoThisViewer(file_path);
    },

    "set-bcf-view": async ({ bcf_path }) => {
      return applyBcfToThisViewer(bcf_path);
    },

    "clear-ifc-viewer": async () => {
      return clearThisViewer();
    },
  },
});

The callback names and argument names match the MCP tool names and schemas, so there is no second naming system to learn.

Local Development

For local development from this checkout:

Terminal

npm install
npm test

The workspace includes .vscode/mcp.json, so VS Code can run the server from this checkout.

Security

IFC MCP keeps the IFC work on your own machine. It reads your IFC files locally, runs the IFC analysis locally, and opens a local viewer. It does not publish the viewer to the public internet.

Generated reports, BCF files, and IFC files are temporary local download links. IFC MCP does not write generated output files into your project folder by default.

Use IFC MCP only with IFC/BIM files and project folders you trust. It can read the files you ask it to use, and incorrect or misleading model data can lead to wrong reports or generated IFC files.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

27d ago

Most recent push to the default branch.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about IFC MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ifc-mcp": { "command": "npx", "args": ["-y", "IFC MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ifc-mcp?style=directory)](https://allmcps.com/mcp/ifc-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/ifc-mcp"><img src="https://allmcps.com/api/badge/ifc-mcp?style=directory" alt="IFC MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

41Quality signal: Fair · 41/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity6/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to IFC MCP →Install in Claude Desktop Install in Cursor Install in VS Code