Revit MCP

🚀 xml.Revit.MCP Tool Overview

English | Chinese Documentation

xml.Revit.MCP provides a comprehensive toolset for integrating with Autodesk Revit through the Model Context Protocol (MCP). This library serves as a bridge between AI assistants and Revit, enabling powerful automation capabilities and supporting programmable interactions with building models.

✨ Features

This tool library includes numerous functions for Revit automation and interaction:

Basic Operations

• Retrieve available commands for Revit plugins.
• Execute specified Revit commands.
• Invoke specific Revit functions with parameters.
• Obtain view data and selected elements.

Element Management

• Find elements by category.
• Get element parameters and positions.
• Update element parameters.
• Delete elements.
• Display/highlight elements in the current view.
• Move elements to new positions.

Creation Tools

• Create floors/planes.
• Create floor plan views.
• Create grid lines.
• Create walls and floors.
• Create rooms and room tags.
• Create doors and windows.
• Create MEP elements (ducts, pipes, cable trays).
• Create family instances.
• Link DWG files.
• Create sheets.

📦 Installation Requirements

• xml.Revit: Version 1.3.4.3 or higher.
• Python: 3.10 or higher.
• UV Package Manager: Install the required tools.
• Revit: Compatible with versions from 2019 - 2024 (requires plugins).

📦 Installation Steps

1. First, install the UV package manager:

   pip install uv
   

2. Install the revit - mcp package:

   pip install revit-mcp
   

3. Test the installation:

   uvx revit-mcp
   

   You should see: RevitMCPServer - INFO - Successfully connected to Revit

💻 Usage Examples

Integration with AI Assistants

Claude for Desktop

Edit the claude_desktop_config.json file and add the following content:

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cursor

Edit the mcp.json file and add the following content:

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cline

Edit the cline_mcp_setting.json file and add the following content:

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Extended Functionality

You can implement more features by creating custom MCP DLL files:

1. Implement the xml.Revit.MCP.Public.IMCPMethod interface.
2. Communicate following the JSON - RPC 2.0 specification.
3. Compile it into a DLL file and place it in the specified MCP folder.

Plugin Configuration

When using the revit - mcp - plugin:

1. Register the plugin in Revit.
2. Configure commands through: Add - in → Revit MCP Plugin → Settings.
3. Enable the service: Add - in → Revit MCP Plugin → Revit MCP Switch.

After enabling, the AI assistant can discover and control your Revit program, executing various commands provided by the xml.Revit.MCP tool library.