# bim-cli

> bim-cli is a free MCP server for developer tools. Let coding agents drive Revit, AutoCAD, SketchUp, Blender and PDFs on your Windows PC. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Windows, CLI
- **Website:** https://bimcli.com
- **Repository:** https://github.com/hellohowareyouhaveaniceday/bim-cli-plugin
- **MCP Registry name:** com.bimcli/bim-cli
- **Categories:** developer tools, files and documents
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/bim-cli
