playbooks

Home / MCP / Revit MCP Server

Revit MCP Server

Bridges Claude AI with Revit via WebSocket to access model data, elements, and views in real time.

typescript
15stars
View on GitHub
Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
    "mcpServers": {
        "revit_mcp": {
            "command": "D:/path/to/revit-mcp-server/build/index.js",
            "args": [],
            "env": {
                "REVIT_HOST": "127.0.0.1",
                "REVIT_PORT": "8080"
            }
        }
    }
}

You run a TypeScript MCP server that connects Claude AI to Autodesk Revit via a WebSocket, enabling real-time access to model data, element queries, and view/level control with robust error handling and mock fallbacks when needed.

How to use

To use this MCP server, start it locally and connect your MCP client to its standard input/output interface. Your client can request model information, query and operate on elements, and navigate views and levels in real time. If the Revit connection is unavailable, the server automatically falls back to mock data so you can continue development and testing without blocking workflows.

How to install

Prerequisites you need before installing the MCP server are listed here:

• Node.js v14 or higher

• npm

• Autodesk Revit (2023 or later)

• Revit WebSocket Plugin (companion plugin)

Step-by-step installation commands

# Install dependencies
npm install

# Build the MCP server
npm run build

# For development with auto-rebuild
npm run watch

Additional configuration and usage notes

Configure the server to connect to the Revit WebSocket plugin using environment variables. Set the host and port where the Revit plugin is listening.

REVIT_HOST=127.0.0.1    # Revit plugin WebSocket host
REVIT_PORT=8080         # Revit plugin WebSocket port

Server configuration (MCP connection)

The MCP server is exposed as a local stdio process. Use the following configuration to run and expose the server to your MCP client.

{
  "mcpServers": {
    "revit_mcp": {
      "type": "stdio",
      "name": "revit_mcp",
      "command": "D:/path/to/revit-mcp-server/build/index.js",
      "args": []
    }
  }
}

Tools and capabilities

The MCP server exposes a set of practical tools that you can use through your MCP client:

  • getModelInfo — Retrieve basic model metadata (name, path, version) and real-time state information.
  • queryElements — Query elements with flexible filtering and retrieve properties and geometry.
  • getElementProperties — Access element properties for inspection and batch operations.
  • navigateViews — List available views and access level information, aiding navigation through the model hierarchy.

Available tools

getModelInfo

Fetches basic model metadata such as name, path, version, and real-time state.

queryElements

Queries elements with flexible filters and returns element data including properties and geometry.

getElementProperties

Retrieves detailed properties for given elements, enabling batch retrieval and inspection.

navigateViews

Lists available views and provides information about levels and model hierarchy to support navigation.