sharafutdinovdi/revit-model-mcp

Ask questions about the model, check it, and change it in plain language.
Every change is one named undo entry in Revit, and read-only mode is one switch away.
Claude Desktop runs on a Mac and connects to Revit 2026 on a Windows workstation.
Actions are enabled in this recording.
What happens in the recording
1. "What model is open in Revit right now?" The client reads the document, levels and room counts.
2. "Which level has the most room area? Find the largest room and show it to me." The client aggregates room areas by level and queries the largest room.
revit_show opens a matching plan and selects the room.
3. "Isolate that room, place a Chair-Breuer at its centre and move it 800 mm along X." revit_isolate, then revit_place_family at the room's roomCenterMm, then revit_move. Each mutation is its own Revit transaction.
4. Cleanup afterwards is one more sentence: reset the view, delete the chair.
Why Model MCP
- **Safe by design.** Each change is one named undo entry in Revit, and one setting makes the whole server read-only.
- **Confirmation first.** Saving, syncing and other irreversible steps wait for your explicit approval.
- **Installs like normal software.** MSI installers, with deployment guides for SCCM, Intune and Group Policy.
- **Works from a Mac.** MCP stdio runs through SSH to the Windows workstation, so no port opens.
Quick start
You need two parts: the add-in inside Revit on Windows, and the server next to your MCP client.
Details and requirements are in requirements and installation.
**1. Install the add-in.**
On the Windows machine with Revit, download RevitModelMcp- -SingleUser.msi (current user) or RevitModelMcp- -MultiUser.msi (all users) from the latest release.
Install only one of them.
Run it with Revit closed, start Revit and open a model.
Revit asks whether to load the add-in, because release builds are not code-signed yet.
**2. Add the server to your MCP client.**
Install uv, then register the server.
For Claude Code on the same Windows machine:
For Claude Desktop, open the revit-model-mcp- .mcpb bundle from the latest release, or add this to its MCP configuration:
On macOS or Linux, use a remote workstation instead of REVIT_MCP_HOST=local.
The Claude Desktop bundle page explains its settings form.
**3. Ask a first question.**
Restart the client, keep a model open in Revit and ask: "Call revit_ping, then tell me which model is open."
success: true means both parts are connected.
From a clone, uv run --directory server revit-model-mcp runs the same server without installing the package.
Try these prompts
Paste any of these into your MCP client with a model open in Revit.
The last column names the tools each prompt uses.
| Goal | Prompt | Tools |
| --- | --- | --- |
| Review | "Give me an overview of the open model: levels, element counts by category, links and the biggest problems." | revit_document_info, revit_list_catalog, revit_aggregate_elements, revit_list_warnings |
| Health check | "Run a health check before we issue this model and list what fails." | revit_model_health, revit_parameter_fill_check |
| Find and show | "Find the doors on this floor and show me where they are in 3D." | revit_query_elements, revit_capture_elements |
| Highlight | "Colour those doors red on the L2 plan and fade everything else." | revit_activate_view, revit_override_graphics |
| Change, then undo | "Move the selected elements 500 mm along X. Preview it first, then do it, then undo it." | revit_move with dry_run, revit_undo_last |
| Batch over a folder | "Collect read-only snapshots of every model in this folder and tell me which ones have parameters left empty." | revit_batch_start, revit_batch_status, revit_build_report |
| ISO 19650 register | "Check this model against our EIR and write an issue register to Excel with element snapshots." | revit_issue_register, with the ISO 19650 skill |
| Export | "Export the L2 plan as PDF, and a Navisworks file of the whole model." | revit_export, revit_export_nwc |