Query a Revit model in plain language through an MCP connector (read-only first)

Short answer

The Model Context Protocol (MCP) lets AI assistants connect to tools. Open-source Revit MCP servers expose Revit actions to an agent. Start here: read the repo README and install on a test machine only. Keep a person in the loop: Community software, not vendor supported. Never run on a live central model.

The problem

Let an AI agent read and edit a Revit model through plain-language commands. This is a common, time-consuming task for a structural engineer.

What this workflow does

The Model Context Protocol (MCP) lets AI assistants connect to tools. Open-source Revit MCP servers expose Revit actions to an agent.

How it works: An AI agent calls connected tools to carry out bounded actions. You set permissions and review the result.

Your checkpoint: Community software, not vendor supported. Never run on a live central model.

Execution boundary

Trigger: you send a plain-language request.
Tools: the connector’s model query functions, where supported.
Permitted actions: start read-only; allow edits only on a detached copy after you approve each call.
Approval: inspect every tool call before it runs.
Recovery: disconnect on an unexpected action and discard the copy.

Before you start

Access to the named tool; confirm license, version and cost with the vendor.
A small, non-confidential sample to try the workflow on first.
A qualified person to review the output before it is used.

Tools and access

Follow the steps

Read the repo README and install on a test machine only.
Connect it to an MCP-capable AI assistant.
Start with read-only questions (count elements, list levels).
Only allow edits on a detached copy of the model.

Try a small example

Replace the bracketed fields with your own project details. No tested sample run is published for this workflow yet.

Sample input

Fill in the bracketed [fields] in the text below with your project data.

Starter prompt

List every structural framing element on Level 2 with its type and length. Do not modify the model.

Expected output

Not published yet. Treat any output as a draft and check it against the source documents.

Check the result

Every value, citation or quantity traces back to a source document.
Missing information is marked as missing, not filled in.

Limits and recovery

Community software, not vendor supported. Never run on a live central model.
Check your organization’s data policy before sharing project files with third-party tools.

Stop or switch when: The source cannot be verified, permissions are missing, or the result contains unsupported facts.

Frequently asked questions

How do I query a Revit model in plain language through an MCP connector (read-only first)?

Read the repo README and install on a test machine only. Connect it to an MCP-capable AI assistant. Start with read-only questions (count elements, list levels). The full step list is above.

Does this use an AI agent or regular software?

It is labeled Agent executes: An AI agent calls connected tools to carry out bounded actions. You set permissions and review the result.

What tools do I need?

revit-mcp, Model Context Protocol. Confirm license, version and cost with the vendor, and try it on a small non-confidential sample first.

Can I use the output without checking it?

No. Community software, not vendor supported. Never run on a live central model.

Has this workflow been tested?

Workflow guide · not independently tested. It is written from vendor documentation and practitioner use.

Evidence and maintenance

Written from vendor documentation and practitioner use. Labels apply to the steps described here, not every feature of a product. Links were checked when the page was written.