Revit MCP logo

Revit MCP

Connects AI clients to Autodesk Revit for BIM automation, analysis, documentation, quantity takeoff, and code checks.

Install Revit MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "revit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuotao/revit-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Revit MCP connects AI clients to Autodesk Revit through MCP, a Node.js stdio bridge, and a local WebSocket service on port 8964. Its Revit add-in executes workflows through the Revit API, covering model changes, view and sheet documentation, quantity takeoff, geometry analysis, and building-code checks. Reach for Revit MCP when a BIM engineer or architect wants to perform repeatable Revit operations using natural-language requests. Revit 2022–2026 on Windows is required, along with installation of the matching C# add-in.

Use cases

  • Automate wall, sheet, viewport, and view-template documentation
  • Analyze Revit geometry for penetrations, slopes, clearances, and room conditions
  • Run building-code checks on openings, smoke exhaust, stairs, and sanitary fixtures
  • Calculate scaffold quantities from walls, rooms, or traced detail geometry
  • Batch-update model types, materials, room heights, and curtain-wall patterns

Key features

  • 239 Revit tools exposed through MCP
  • Local Node.js stdio bridge with WebSocket forwarding
  • Revit 2022–2026 add-in support
  • BIM documentation and model-editing workflows
  • Quantity takeoff and geometry analysis
  • Building-code-oriented review tools

Tools167

What Revit MCP lets your agent do. Expand a tool for its parameters.

Verified live~24.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

15/15 checks healthy over the last 60d

What it can do

From the 167 tools this server returned when we ran it; 167 declare their own safety hints.

Can delete or modify data · 2Handles credentials · 3Read-only tools · 165
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age91 days
Maintainers1

Observed 2026-10-15 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @shuotao/revit-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars110Stargazers on the source repository.
npm downloads262Package downloads in the last 30 days.
Last commit14d agoMost recent push to the default branch.
Tools exposed167Callable tools this server registers over MCP.
Directory activity9 viewsConfig copies, upvotes, and views on AllMCPs.

How Revit MCP works

What Revit MCP does

Revit MCP lets an MCP-compatible AI client issue commands to Autodesk Revit. The package includes a Node.js/TypeScript MCP server and a separate C# add-in that runs inside Revit. The repository describes 239 runtime tools spanning BIM production workflows, quantity takeoff, analysis, and compliance-oriented checks.

The toolset can modify model data and documentation. Examples include changing element types, assigning existing materials, setting room heights, applying view templates, arranging drafting viewports, aligning titleblocks, creating wall dimensions, renumbering sheets, and applying curtain-wall panel patterns. Other tools inspect geometry and model relationships, such as beam penetrations, corridor widths, floor slopes, tall partitions, smoke detectors, and grid bounds.

Several tools support building review and takeoff workflows. These include exterior-wall opening checks, effective floor-opening checks, smoke-exhaust window checks, stair headroom checks, sanitary-fixture calculations for C-1 factory or warehouse projects, and scaffold perimeter calculations based on walls, rooms, or selected detail geometry.

How it works

The AI client launches the Node-based MCP process over stdio. That process forwards requests through a WebSocket connection to the Revit add-in at ws://localhost:8964. The add-in invokes Revit API operations through the running Revit application, so Revit must be open with the MCP service enabled from its ribbon.

Only one AI client can hold the Revit-side connection at a time. To change clients, release the existing connection from the Revit ribbon and then connect the replacement client. Browser-origin WebSocket handshakes are rejected, while the local MCP bridge does not send an Origin header.

Setup and configuration

Supported environments are Windows 10 or later, Autodesk Revit 2022 through 2026, and Node.js LTS, preferably 20.x or later. Revit 2022–2024 uses .NET Framework 4.8 for the add-in; Revit 2025–2026 uses .NET 8.

The package can be started without cloning with:

Terminal
npx -y @shuotao/revit-mcp-server

This command installs only the Node stdio bridge. The C# add-in must also be built for the installed Revit version and deployed to the matching Revit Addins directory. A project configuration can launch the built bridge with node MCP-Server/build/index.js; the repository also provides setup and deployment PowerShell scripts.

Tools and capabilities

  • Modify Revit elements, types, materials, rooms, views, sheets, and curtain walls.
  • Create dimensions, sections, filled regions, and other documentation artifacts.
  • Analyze walls, floors, beams, rooms, openings, slopes, corridors, and MEP-related conditions.
  • Calculate scaffold perimeters from exterior walls, rooms, or selected detail geometry.
  • Run building-code-oriented checks and color-code some review results in Revit.
  • Batch operations with selection filters, previews, ordering, or grouped updates where supported.

Limitations and notes

The add-in is required for the npm package to perform Revit operations. Revit-side connectivity is local rather than a hosted service. AI clients are switched rather than connected concurrently because the add-in enforces an exclusive connection lock.

Some capabilities have defined scope. The sanitary-fixture requirements tool currently handles C-1 factory and warehouse projects and calculates results without writing Revit parameters. Several batch tools target specific view types or selection methods; for example, viewport arrangement is limited to DraftingView viewports. The interactive clash viewer requires an MCP host that supports the MCP Apps extension; unsupported hosts receive the normal text result.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Revit MCP

Revit MCP is an MCP server that connects AI clients to Autodesk Revit through a Node.js stdio bridge and a local Revit add-in. Its main tools modify model elements and documentation, analyze BIM geometry, calculate quantities, and run building-code-oriented checks. Revit 2022–2026 on Windows is required.

Install the Node bridge with `npx -y @shuotao/revit-mcp-server`, then separately build and deploy the C# add-in for the installed Revit version. Open Revit, enable the MCP service from its ribbon, and configure the AI client to launch the bridge over stdio.

Yes, Revit MCP provides a Claude Desktop configuration template. Add the server to Claude Desktop's configuration and launch the Node bridge, then ensure the matching Revit add-in is installed and the MCP service is enabled in Revit.

No, only one AI client can hold the Revit-side WebSocket connection at a time. Release the current connection from the Revit ribbon before starting or reconnecting another client.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRevit MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/revit-mcp?style=directory)](https://allmcps.com/mcp/revit-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/revit-mcp"><img src="https://allmcps.com/api/badge/revit-mcp?style=directory" alt="Revit MCP on AllMCPs" /></a>