Home / Blog / MCP walkthrough
Product walkthrough

Claude + Revit: Control Your Model in Plain English with MCP

A walkthrough of Revit MCP, an AI-powered tool that lets you control Revit using plain English commands. Find elements, bulk-update parameters, and export data without touching Revit's UI.

What is Revit MCP?

Revit MCP (Model Context Protocol) is a system that connects Revit to Claude, an AI assistant, so you can give instructions in plain English and have them executed directly inside your model. Instead of clicking through menus or navigating Revit's interface to track down what you need, you type something like "find all rooms missing a department parameter" or "set the fire rating on every door in Phase 2 to 90 minutes" and it happens.

MCP is an open protocol developed by Anthropic that allows AI models to connect to external tools and data sources. The Revit implementation I built creates a live bridge between Claude Desktop and a running Revit session, giving the AI the ability to read from and write to your model in real time.

How do you connect Claude to Revit?

You need three pieces: Claude Desktop, a Revit MCP server, and a supported version of Revit running with your project open. Claude Desktop is where you type. The MCP server sits between Claude and Revit, turns your request into actions in the model, and sends the results back. Revit can stay minimized while it works.

Which server you can use depends on your Revit version. Autodesk's own Revit MCP is a Tech Preview for Revit 2027 only (here's what to check if it isn't working). The version I build runs on Revit 2024 and later, has been in production for over a year, and is set up around your firm's standards.

Each person using it needs a Claude seat (an individual plan or a seat on a company Claude Team plan), billed by Anthropic, and for daily production use you should plan on a paid Claude plan. You don't configure anything yourself: I handle the server setup, the Claude Desktop configuration, and end-to-end testing during onboarding. Your .rvt file never leaves your machine. Only the results of each query go to Claude (details in our privacy policy).

What can you do with natural language Revit control?

The short answer: anything that involves reading elements, filtering by criteria, or updating parameters at scale. Here are some real examples of what you can ask:

  • Find all walls where the "Fire Rating" parameter is empty
  • Count how many doors are in each phase of the project
  • Set the "BIM Status" parameter to "Coordinated" for every structural column on Level 3
  • Export a list of all rooms with their area, department, and occupancy to CSV
  • Flag every element where the mark parameter does not match the naming convention
  • Update room finish parameters from an external spreadsheet

The capability that separates MCP from a static script is conditional logic. You can give it instructions like "if the room area is over 500 SF and the occupancy type is Assembly, set the egress width to 72 inches." That kind of if/then reasoning is where natural language control really earns its place, and where one-click pyRevit buttons hit their limit.

How Revit MCP is different from pyRevit buttons

Both tools automate Revit, but they solve different problems.

PyRevit buttons are best when the task is always the same: same inputs, same logic, same output every time. You click a button, it runs, done. That works well for things like renaming views to match a firm's naming convention, syncing room data from a known CSV format, or running a compliance audit against a fixed set of rules. The process is deterministic and repeatable.

Revit MCP is better when the task varies. Maybe the elements you need to update change project to project. Maybe the logic depends on parameter values you do not know in advance. Maybe you want to ask a question about your model ("how many elements have conflicting fire ratings?") without building a schedule or writing a query first. MCP handles that through conversation.

A lot of teams end up using both: pyRevit for the high-frequency, always-the-same tasks, and MCP for complex, one-off, or investigative work.

Who is Revit MCP built for?

Revit MCP is built for BIM managers, project architects, and senior Revit users who spend meaningful time on model data work: audits, parameter management, coordination tasks, data exports. People who want to do that work faster without writing code or learning the Revit API.

You do not need any programming background. You do not need to know Python or Dynamo. You just need to be able to describe what you want in plain English, the same way you would describe it to a colleague.

It earns its keep on any project where you have real data management work to do. The value is in the type of work, not the size of the model. A 30-unit residential project with inconsistent parameter data is just as good a use case as a 500,000 SF hospital.

See it in action

The best way to understand what Revit MCP can do is to watch it. This demo covers the full range: querying elements, bulk parameter updates, schedule creation, and CSV export, all through natural language with no coding required.

Demo · Revit MCP v1.0 Watch on YouTube ↗

If you want to see what this could look like for your team's workflows, schedule a free demo and we can walk through it together.

Founding pilot

Your firm gets 30 days of full access at no cost. No subscription, no onboarding fee. The only ask is a 15-minute feedback call at the end of the trial. Apply for the pilot.

From the blog
Ready when you are

Ready to cut the manual work?

Tell me what you're working with and I'll put together a custom quote. Takes about 2 minutes. No sales call, no pressure. Direct response from me within 48 hours.

About me. I'm a BIM specialist with 15 years doing production shop drawings and structural coordination, where a wrong parameter costs real money. I built these tools for myself because I was spending hours on tasks that should take minutes, and I was tired of it. I'm still doing this work every day, which means every automation I build comes from a real frustration on a real project.

Eric Upshur

Apply for Pilot Access