How to connect Claude to Revit, and stay in control of your model
Install BIMBridge with one prompt, ask your first read-only questions, and learn how Keep, Discard and Ctrl+Z keep every AI change under your control.
Asking Revit a question in plain English sounds like a demo trick until you try it on a real model. “Which ducts on Level 02 have no insulation?” is a filter, a schedule and ten minutes of clicking. With an AI connected to Revit, it is one sentence.
This guide shows how to set that up with BIMBridge, a free connector, and how to keep full control of your model while you do it.
What you need
- Windows 10 or 11 and Revit 2022 or newer
- Claude Desktop (the free plan works), Claude Code, or the ChatGPT app with Codex
- pyRevit 7 or newer. If you don’t have it, the installer adds it.
BIMBridge uses the MCP server that ships with pyRevit 7. MCP is the standard way AI apps talk to other software; if the term is new, this plain-English guide explains it in five minutes.
Install it
There are two ways. Pick one.
Option A: one prompt. This needs Claude Pro or higher. In Claude Desktop, open the Code tab and paste:
Install BIMBridge to connect Claude to my Revit: https://github.com/kenpro0/bimbridge-mcp
Follow INSTALL.md step by step, then tell me what to do next.Claude asks for your permission before each command. Windows may also ask to install .NET or WebView2 for pyRevit. Click Yes.
Option B: one command. This works on the free plan. Close Revit, open PowerShell (not as administrator) and paste:
irm https://raw.githubusercontent.com/kenpro0/bimbridge-mcp/main/install.ps1 | iexWhen it finishes, start Revit, open a project, then quit your AI app completely and open it again. In Claude Desktop that means right-clicking the Claude icon near the clock and choosing Quit. Closing the window is not enough.
Start with questions, not changes
Your first hour should be read-only. Ask things you can check yourself, so you learn how the AI reads your model before you let it touch anything:
- “List the levels in my model with their elevations.”
- “Count the elements in the active view by category.”
- “Which rooms have no number?”
- “Find mechanical equipment with a duplicate Mark value.”
Compare the answers with what you see in Revit. When they match, you know the connection works and you have a feel for how precise you need to be.
How changes work
When you ask for a change, the AI writes a short script and runs it inside Revit. Revit then asks you to Keep the change or Discard it. Nothing stays in your model until you click Keep, and every change you keep undoes with a single Ctrl+Z.
The AI can also take a capture of a view to check its own result. Ask for it: “Add 25 mm insulation to those ducts, then show me a 3D view of Level 02.”
Five habits that save you
- Work on a copy first. Detach a model or save a test copy before your first real change.
- Be specific. Name the level, the system, the units. “Ducts on Level 02 in the Supply Air system” beats “the ducts”.
- Ask for a count before a change. “How many elements would this affect?” catches misunderstandings early.
- Read the summary before you click Keep. It takes ten seconds.
- Mind confidentiality. What the AI reads from your model, such as names, parameters and view captures, is sent to the AI provider. Check your project’s rules before using it on client work.
Where to go next
The BIMBridge page has more prompts to try. If you work in Archicad, ArchiBridge does the same job there. And if you want a guided path through all of this, the AI for your everyday BIM workflow course is open for the waitlist.