Skip to content
MCP server

bim-cli

Let coding agents drive Revit, AutoCAD, SketchUp, Blender and PDFs on your Windows PC

Runs locallyStatus and history
Install
Pricing
Free
Platforms
Windows, CLI
Runs
Locally
Version
0.35.1
Listing updated
3 days ago

About bim-cli

bim-cli is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.

bim-cli is a free Windows command-line tool that an AI assistant runs on your own machine, so drawings and models never leave it. There is no admin requirement and no account. Revit 2024 to 2027 is supported, and the assistant orients itself with bim doctor and bim describe, which return JSON including a fix field for each failed check.

The verbs the site shows are practical: check a drawing-set PDF for missing sheets, unresolved callouts and title-block mismatches; produce a flood-zone site report for a US address; export all Revit sheets to PDF; and compress a PDF locally. Output is JSON on stdout with a documented error envelope and exit codes.

It needs an assistant that can run shell commands, such as Claude Code, Codex or Cursor. Chat-only apps cannot use it, though Claude Desktop can with one setup step. It is made by Small Tiger Group.

Install

Run in a terminal

claude mcp add bim-cli -- npx -y https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/releases/download/mcpb-v0.35.1/bim-cli-0.35.1.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "bim-cli": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/releases/download/mcpb-v0.35.1/bim-cli-0.35.1.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bim-cli": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/releases/download/mcpb-v0.35.1/bim-cli-0.35.1.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "bim-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/releases/download/mcpb-v0.35.1/bim-cli-0.35.1.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bim-cli": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/releases/download/mcpb-v0.35.1/bim-cli-0.35.1.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bim-cli": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/releases/download/mcpb-v0.35.1/bim-cli-0.35.1.mcpb"
      ]
    }
  }
}

What it does

Revit sheet export
Exports a whole sheet set to PDF through Revit.
Drawing-set checks
Finds missing sheets, unresolved callouts and title-block mismatches.
US site reports
Flood zone, zoning, landmark and transit layers in one PDF.
Local PDF compression
Shrinks PDFs without uploading them.
Self-describing CLI
bim describe and bim doctor give agents JSON readiness and fixes.
No admin or account
Per-user install that keeps files on your PC.

Good for

  • Export every Revit sheet without clicking through Revit
  • QA a drawing-set PDF before issue
  • Produce a flood-zone report for an address
  • Let an agent compress and process project PDFs

Pricing

Free

Free, offline Windows CLI

Prices change. Check bimcli.com before you buy.

bim-cli FAQ

Which Revit versions work?

Revit 2024 through 2027.

Does it need an account or admin rights?

No.

Can I use it from a chat window?

Chat-only ChatGPT or Claude cannot run programs on your PC; Claude Desktop can with one setup step.

Do my files leave the PC?

The site says the tool runs on your PC and your files stay there.

Is bim-cli free?

Yes. bim-cli is free to use.

How do I add bim-cli to Claude Code?

Run this command in your terminal: claude mcp add bim-cli -- npx -y https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/releases/download/mcpb-v0.35.1/bim-cli-0.35.1.mcpb

What are the best alternatives to bim-cli?

The closest alternatives to bim-cli are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to bim-cli

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools