Revit MCP Server
The Revit MCP Server serves as a bridge enabling Claude AI to interact with Autodesk Revit models in real-time via WebSocket connections.
Key capabilities:
π Real-time Communication: WebSocket-based connection for live model interactions
π Model Information: Access metadata, element counts, and model state
ποΈ Element Management: Query, filter, and manage elements with their properties and geometry
πͺ View & Level Control: Navigate through and list views and levels
π Schema Operations: Retrieve categories, families, elements, and detailed information
βοΈ Customizable: Configure connection settings via environment variables
π‘ Error Handling: Fall back to mock data when Revit connection is unavailable
Provides real-time access to Revit model information, element querying and filtering, view and level management, and model metadata access through a WebSocket connection with the Revit plugin.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Revit MCP Server show me all the doors in the current model"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ποΈ Revit MCP Server
A Model Context Protocol server for Revit integration, enabling seamless communication between Claude AI and Autodesk Revit.
π― Overview
This TypeScript-based MCP server provides a bridge between Claude AI and Revit, allowing direct interaction with Revit models through a WebSocket connection. It implements the Model Context Protocol to enable:
β‘ Real-time access to Revit model information
π Element querying and filtering
π View and level management
π‘οΈ Robust error handling with fallback mock data
Related MCP server: QGISMCP
β¨ Features
π Revit Integration
π‘ WebSocket-based communication with Revit plugin
π Real-time model data access
π Graceful fallback to mock data when connection fails
βοΈ Configurable connection settings via environment variables
π Core Functionalities
π Model Information
Access basic model metadata (name, path, version)
Get element counts and last modification date
Real-time model state synchronization
ποΈ Element Management
Query elements with flexible filtering
Access element properties and geometry
Batch element operations
πͺ View & Level Control
List all available views
Access level information
Navigate through model hierarchy
π» Development
π Prerequisites
Node.js (v14 or higher)
npm
Autodesk Revit (2023 or later)
Revit WebSocket Plugin (companion plugin)
π§ Installation
Install dependencies:
npm installBuild the server:
npm run buildFor development with auto-rebuild:
npm run watchβοΈ Configuration
The server can be configured using environment variables:
REVIT_HOST=127.0.0.1 # Revit plugin WebSocket host
REVIT_PORT=8080 # Revit plugin WebSocket portπ Integration with Claude Desktop
Add the server configuration to Claude Desktop:
Windows:
%APPDATA%/Claude/claude_desktop_config.jsonConfiguration format:
{
"mcpServers": {
"revit-mcp-server": {
"command": "D:/path/to/revit-mcp-server/build/index.js"
}
}
}π Debugging
For debugging the MCP communication:
Use the built-in MCP Inspector:
npm run inspectorMonitor WebSocket communication with Revit plugin
Check server logs for connection and operation status
β οΈ Error Handling
The server implements robust error handling:
Automatic fallback to mock data when Revit connection fails
Detailed error logging
Graceful connection recovery
π License
MIT License
π€ Contributing
Contributions are welcome! Please feel free to submit pull requests.
π¬ Contact
If you have any questions or suggestions, feel free to reach out:
π§ Email: 353554036@qq.com
π¬ WeChat Account: modian4500
Available Tools
6 toolsget_categoriesB
θ·ε Revit 樑εδΈηζζη±»ε«
Inputs: no named parameters.
get_element_infoC
θ·ε Revit ε η΄ ηθ―¦η»δΏ‘ζ―
Inputs: elementId (required), getItemPropertyInfo, getItemParameterInfo.
get_elementsC
θ·ε Revit 樑εδΈηε η΄
Inputs: categoryIds, viewIds, levelIds.
get_familiesC
θ·ε Revit 樑εδΈηζζζ
Inputs: categoryId, name.
get_levelsB
θ·ε Revit 樑εδΈηζζζ₯Όε±
Inputs: no named parameters.
get_viewsB
θ·ε Revit 樑εδΈηζζθ§εΎ
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 6 tools
Every tool has a clearly distinct purpose targeting different Revit model components: categories, element info, elements, families, levels, and views. There is no overlap in functionality, and an agent can easily distinguish between them based on the specific resource each retrieves.
All tools follow a consistent verb_noun pattern with 'get_' as the prefix and a plural or singular noun describing the resource. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming style.
With 6 tools, the count is reasonable for a Revit model server, covering key retrieval operations. However, it might be slightly under-scoped as it lacks tools for creating, updating, or deleting elements, which could be expected in a full Revit integration.
The tool set is severely incomplete for a Revit domain, as it only provides read-only retrieval operations. There are significant gaps in CRUD coverageβno tools for creating, updating, or deleting elements, categories, families, etc., which will likely cause agent failures when trying to modify models.
Related MCP Connectors
Convert Revit files to XKT, IFC, or DWG and query BIM data via natural language.
AI for Revit: 450+ tools, 1 undo step. Windows, Revit 2024β2027 (2021β2023 included). Free account.
AI Hub for AEC β 50+ 3D formats, clash detection, ACC integration via Autodesk Platform Services.
Revit model integration via APS β elements, parameters, schedules, clashes, IFC export.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceConnects Rhino3D to Claude AI via the Model Context Protocol, enabling AI-assisted 3D modeling and design workflows through direct control of Rhino's functionality.13-
- FlicenseNot gradedqualityDmaintenanceConnects QGIS to Claude AI through the Model Context Protocol, enabling AI-assisted project creation, layer manipulation, processing algorithm execution, and Python code running within QGIS.7-
- AlicenseBqualityDmaintenanceConnects Blender to Claude AI through the Model Context Protocol, enabling AI-assisted 3D modeling, scene creation, and manipulation through natural language commands.172MIT
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI assistants like Claude to interact with Autodesk Construction Cloud Build platform for construction project management, including issues tracking, RFIs, submittals, and document management through natural language.-