Model MCP

Model MCP for Autodesk® Revit® connects Claude Desktop, Claude Code or any MCP client that starts a stdio server to a live Revit project. Ask questions about the model, check it, and change it in plain language. Committed transactional model edits create one named Undo entry in Revit. Read-only mode is one switch away.

Install with an AI agent

On Windows, paste this prompt into Claude Code, Codex, Cursor, or another agent: Install Model MCP for Revit from https://github.com/sharafutdinovdi/revit-model-mcp. Follow docs/agent-install.md exactly. The agent install guide uses the published MSI and client registration, with no checkout or .NET SDK. The one-command installer arrives with the next release; the current release does not contain install.ps1.

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. Tested with Claude Desktop over SSH; other clients are listed on the tested clients page.

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. WinGet publication is pending. The submission is open, and the package is not yet in the catalog. Use an MSI from the latest release until it is accepted.

Keep Revit closed during installation, then 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. In Revit, Model MCP > Model MCP > Connect AI app registers the bundled server in Claude Desktop, Cursor, VS Code, or Codex (the ChatGPT app or codex CLI); Claude Code gets a copy-paste command. The MSI includes the server executable, so this path needs no separate Python or uv installation.

If you prefer the PyPI server: Install uv, then register the server. For Claude Code on the same Windows machine:

claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -e REVIT_MCP_REDACT_PATHS=1 -- uvx revit-model-mcp

For Claude Desktop, open the revit-model-mcp- .mcpb bundle from the latest release, or add this to its MCP configuration:

{

"mcpServers": { "revit-model-mcp": { "command": "uvx", "args": ["revit-model-mcp"], "env": { "REVIT_MCP_HOST": "local", "REVIT_MCP_REDACT_PATHS": "1" } } } }

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.

For updates, the release add-in checks GitHub daily and notifies by default; the PyPI server checks PyPI, or install the newer MSI (updates). Report bugs in Issues, ask questions in Discussions, and report vulnerabilities through SECURITY.md.

Why Model MCP

• Model edit controls. Transactional model edits create one named Undo entry, and one workstation lock enables read-only mode.
• 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.

Features in 2.0

• Model MCP ribbon tab. The product menu contains About, Check for updates, and Settings. The panel provides Connect AI app, Activity, My tools, Read-only, Help, Report issue, and Support developer. After a channel permission refusal, Activity explains the problem. Model MCP > Repair channel permissions offers a confirmed repair of the reviewed folder permissions. See channel permissions. Update checks depend on the release channel. Buttons have contextual help and themed tooltips. See the ribbon guide.
• Workstation read-only lock. The ribbon and revit_set_read_only control one lock across running Revit versions for the Windows user. Chat unlock requires explicit confirmation. Machine policy remains enforced.
• Model audits. revit_model_audit checks one model against YAML, JSON, inline rules, or a builtin pack. Saved results support history comparisons. revit_audit_report produces XLSX and HTML reports. See model audit.
• Sheet inspection. revit_list_sheets reads sheets, title blocks, revisions, placed views, and unplaced views.
• Revit API lookup. revit_api_lookup reads public types and members from the running Revit API before C# execution.
• Progress notifications. Clients that supply a progress token receive queue state, Revit API availability, and batch step counters during long requests. See progress notifications.
• Document tab highlight. A border marks the document handling MCP work and clears after completion. The ribbon guide covers timing and settings.
• Grouped C# authoring. revit_execute_code and revit_run_tool accept transaction="group" for procedures that need their own transactions or edit scopes. The runner keeps the group within one Undo entry and rolls it back for dry runs or failures.
• Reusable skills. Coordinator, daily QA, sheet set, and ISO 19650 issue register workflows ship in the repository. See prompts and skills.

Upgrading from 1.x

REVIT_MCP_READ_ONLY is no longer used. Remove it from client configuration and set the workstation lock with the Revit ribbon or revit_set_read_only. The lock applies across clients and running Revit versions for the Windows user. Chat unlock requires explicit confirmation, and administrator policy remains enforced. See read-only mode and the 2.0.0 changelog.

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.

What it can do

The tables list every tool by name; the tool reference has arguments, units and limits.

"Show the building going up in construction order."

"Bring the building together piece by piece."

"Show supply and return air moving through the building."

"Colour the model by warnings."

Review a model

Read the model, find problems and show them in Revit. Reads change nothing in the document.

Tools for reviewing a model

| Read views and schedules | revit_list_views, revit_view_info, revit_view_summary, revit_view_elements, revit_schedule_data, `revit_l