Revitmcp

Revit MCP integration is a bridge connecting Autodesk Revit and AI assistants, enabling model interaction through natural language.

Developer tools Artificial intelligence chatbots #Revit Integration #AI Interaction #Model Protocol #Parameter Tool .Python

rating : 2.5 points

downloads : 11

update time : 2025-04-28

What is the Revit MCP Server?

The Revit MCP Server is a tool based on the Model Context Protocol (MCP) standard that allows large language models (such as Claude) to directly interact with Revit building models. Users can query, create, or modify elements in the Revit model by asking questions or issuing instructions in natural language.

How to use the Revit MCP Server?

First, ensure that the required software and dependencies are installed. Then, start the server and connect to the client tool (such as Claude Desktop). By entering natural language commands, you can easily interact with the Revit model.

Applicable Scenarios

It is suitable for architects, engineers, and technicians who need to quickly access or adjust information in Revit models. Whether querying specific elements or batch - modifying model properties, the Revit MCP Server can provide efficient support.

Main Features

Query Model InformationQuery basic information of the Revit model, such as project name, unit settings, etc., through natural language.

Find Specific ElementsFind elements in the model according to categories (such as walls, doors, rooms) or other filtering conditions.

Create New ElementsCreate new building elements by specifying parameters (such as start point, end point, height).

Transaction ManagementSupport starting and committing transactions to ensure that changes to the model are safe and reliable.

Advantages and Limitations

Advantages

Simplify complex Revit operations through natural language

Improve work efficiency and reduce manual input errors

Support cross - platform integration for easy collaboration with other tools

Limitations

Require installation of dependencies such as Python and PyRevit

May require a certain network bandwidth support

Some advanced functions may depend on specific versions of Revit

How to Use

Install Dependencies

Ensure that Python 3.13 and the latest version of PyRevit are installed, and install the required packages via pip.

Start the Revit MCP Server

Copy the extension file to the PyRevit directory, restart Revit, and run the test interface.

Connect to the Client

Configure Claude Desktop to connect to the local MCP server.

Usage Examples

Query All WallsGet all walls and their detailed information in the current Revit model.

Create a New WallCreate a new wall at the specified coordinates.

Frequently Asked Questions

How to solve the problem that the server cannot start?

Why can't I connect to the MCP server?

Related Resources

Official Documentation

Detailed installation guides and technical documentation

GitHub Code Repository

Open - source code and sample projects

🚀 Revit MCP Integration

An integration of the Model Context Protocol (MCP) for Autodesk Revit 2024.3, enabling AI assistants like Claude to directly interact with Revit models via natural language.

🚀 Quick Start

Open Revit and your model.
Navigate to the "RevitMCP" tab in the Revit ribbon.
Click "Start MCP Server" to start the MCP server.
Open Claude Desktop or other compatible MCP clients.
Configure the MCP client to connect to the server.
Start asking questions or giving commands about the Revit model!

✨ Features

Resources: The ability to interact with Revit models through the MCP protocol.
Tools: Interfaces for creating, modifying, and querying Revit elements.

📦 Installation

Download and install Python 3.13 from python.org.
Install the required Python packages:
```
pip install mcp[cli] httpx
```
Install the latest version of PyRevit for Revit 2024.
Copy the RevitMCP.extension folder to your PyRevit extensions folder:
- Usually located at: %APPDATA%\pyRevit\extensions
Reload PyRevit from the Revit ribbon.

📚 Documentation

Overview

This integration allows large language models (LLMs) to:

Query information from Revit models.
Create and modify elements.
Perform complex operations through a standardized interface.

This implementation uses the Model Context Protocol (MCP), an open standard developed by Anthropic that defines how AI models connect to external tools and data sources.

Prerequisites

Autodesk Revit 2024.3 or later.
Python 3.13 (must be installed and available in the PATH).
The latest version of PyRevit.
MCP Python SDK (pip install mcp[cli]).

Using the Test Interface

If you don't have Claude Desktop or other MCP tools, you can use the built - in test interface:

Open Revit and your model.
Go to the "RevitMCP" tab in the Revit ribbon.
Click "Open Test Interface" to start the MCP server.
Select the question or command to send in the interface.
Click the "Send Query" button.

Configuring Claude Desktop Connection

Open Claude Desktop and go to settings.
Add a new API configuration, specifying the type as Revit - MCP.
Fill in the following details:
- Server URL: http://localhost:8080
- Interface Key: your_api_key_here

Example Prompts

Here are some example queries you can send to Claude:

"Generate a new floor plan with 3 bedrooms and 2 bathrooms."
"Add a new two - story structure to the current project."
"Delete all unused Revit elements and clean up the model."

Troubleshooting

Python Errors: Run pip install mcp[cli] httpx to install the required packages.
Revit Errors: Ensure you are using the latest version of PyRevit compatible with Revit 2024.