bim-cli MCP server

bim-cli Claude Code Plugin

Claude Code plugin manifest for bim-cli -- headless Revit export, PDF batch export, flood/site data lookup, and offline AEC tasks. Runs from your AI assistant without Revit or any desktop app open.

Windows-only. bim-cli is a Windows-only CLI. This plugin requires a Windows machine with bim-cli installed.

What this plugin does

Exposes all installed bim-cli verbs as MCP tools in Claude Code. Each tool maps to a bim command running locally on your machine. Example tools:

• bimpdftext -- extract text from a PDF without opening it
• bimpdfstamp -- apply a Bates stamp or watermark to PDF pages
• bimpdfsplit, bimpdfmerge -- split or combine PDF files
• bimsiteflood_lookup -- flood zone lookup by address or coordinates
• bimblenderconvert -- convert IFC/FBX/glTF headlessly

The tool list is generated dynamically from bim describe --json -- adding a new bim-cli driver or verb makes it available automatically.

About this plugin repo

This repository contains only manifest files (JSON and Markdown), plus one stdlib Python maintenance script (scripts/check_skills.py) that the plugin never runs. It contains:

• No executable code in the plugin itself
• No telemetry of its own
• No secrets or credentials
• No network calls

All execution is local: the plugin simply tells Claude Code how to launch the already-installed bim binary as a local stdio MCP server (bim mcp). Nothing runs in the cloud.

Setup

1. Install bim-cli (Windows, run in PowerShell):

iwr -useb https://bimcli.com/install.ps1 | iex

Verify: bim describe --json should list installed drivers.

the following to your .mcp.json in your project root (or via Claude Code settings):

1. Add this plugin to Claude Code via the Claude Code plugin directory, or manually add

{
     "mcpServers": {
       "bim": {
         "type": "stdio",
         "command": "bim",
         "args": ["mcp"]
       }
     }
   }

1. Restart Claude Code. Verify with bim doctor that installed drivers are healthy.

Agent skill (Hermes, Claude Code, and other Agent Skills hosts)

skills/bim-cli/ is an Agent Skills skill that teaches an agent how to drive bim from the terminal: discovery with bim describe, output and error conventions, and working notes for the PDF and Revit drivers. Claude Code loads it automatically with this plugin.

Hermes Agent:

hermes skills tap add HelloHowAreYouHaveANiceDay/bim-cli-plugin
hermes skills install HelloHowAreYouHaveANiceDay/bim-cli-plugin/skills/bim-cli

The skill is Windows-only (platforms: [windows]) and expects bim-cli on PATH. It never runs the installer itself; it hands the PowerShell one-liner to the user.

It is also served from bimcli.com as an Agent Skills well-known endpoint: https://bimcli.com/.well-known/skills/index.json (proxied live from skills/ on main).

hermes skills install well-known:https://bimcli.com/.well-known/skills/bim-cli

Changing a skill

only installs community skills that its scanner rates SAFE. Never put curl ... | bash (or any pipe-to-shell) in a skill; that is a hard block.

1. Edit skills//, bump version: in its frontmatter.
2. python scripts/check_skills.py regenerates skills/index.json (the well-known index).
3. python scripts/check_skills.py --check --scan must pass: Hermes

hermes skills update.

1. Merge to main. The tap and bimcli.com pick it up immediately; Hermes users get it with

Privacy Policy

bim-cli runs entirely on your local machine. The MCP server (bim mcp) does not make network calls beyond what the individual bim-cli verbs themselves make (e.g. a flood lookup calls a public FEMA/NFHL endpoint; a PDF operation makes no network calls at all).

What leaves your machine:

Shortened. The full README is on GitHub.