The Revit MCP Server facilitates automation and programmatic interaction with Autodesk Revit through the Model Context Protocol (MCP). It provides a comprehensive set of tools for:
- Element Creation: Build levels, grid lines, walls, floors, rooms, doors, windows, MEP elements (ducts, pipes, cable trays), family instances, floor plan views, and sheets.
- Element Management: Find elements by category, retrieve parameters and locations, update properties, delete, move, and highlight elements in views.
- View Operations: Activate views, retrieve view data, link DWG files.
- Command Execution: Execute specified Revit commands and functions with parameters.
- Integration Capabilities: Configure and integrate with AI tools like Claude for Desktop, Cursor, and Cline.
- Extensibility: Implement custom MCP DLL files to extend functionality.
Interacts with xml.Revit to enable sending commands to Revit and receiving responses for model manipulation and automation
xml.Revit.MCP Tools Overview
xml.Revit.MCP provides a comprehensive set of tools 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 programmatic interaction with building models.
Key Features
The tool library includes numerous functions for Revit automation and interaction:
Basic Operations:
- Get available commands from Revit plugin
- Execute specified commands in Revit
- Call specific Revit functions with parameters
- Retrieve view data and selected elements
Element Management:
- Find elements by category
- Get element parameters and locations
- Update element parameters
- Delete elements
- Show/highlight elements in current view
- Move elements to new positions
Creation Tools:
- Create levels/floors
- 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 newer
- Python: 3.10 or newer
- UV Package Manager: Required for installation
- Revit: Compatible with versions 2019-2024 (with plugin)
Installation Process
- First, install the UV package manager:
- Install the revit-mcp package:
- Test the installation:You should see:
RevitMCPServer - INFO - Successfully connected to Revit on startup
Integration with AI Assistants
Claude for Desktop
Edit claude_desktop_config.json
to include:
Cursor
Edit mcp.json
to include:
Cline
Edit cline_mcp_setting.json
to include:
Extending Functionality
You can create custom MCP DLL files to implement additional functionality by:
- Implementing the
xml.Revit.MCP.Public.IMCPMethod
interface - Following JSON-RPC 2.0 specification for communication
- Compiling to a DLL and placing it in the designated MCP folder
Plugin Configuration
When using the revit-mcp-plugin:
- Register the plugin with Revit
- Configure commands through: Add-in Modules → Revit MCP Plugin → Settings
- Enable the service: Add-in → Revit MCP Plugin → Revit MCP Switch
Once enabled, AI assistants can discover and control your Revit program, executing the various commands provided by the xml.Revit.MCP tools library.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A Python package that enables integration with Autodesk Revit through the Model Context Protocol, allowing users to send commands to Revit and automate interactions with building models.
- Key Features
- Installation Requirements
- Installation Process
- Integration with AI Assistants
- Extending Functionality
- Plugin Configuration
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that extracts and analyzes Python code structures, focusing on import/export relationships between files to help LLMs understand code context.Last updated -6PythonMIT License
- AsecurityAlicenseAqualityAllows AI to interact with Autodesk Revit via the MCP protocol, enabling retrieval of project data and automation of tasks like creating, modifying, and deleting elements.Last updated -11109TypeScriptMIT License
- -securityFlicense-qualityA Python-based implementation of the Model Context Protocol that enables communication between a model context management server and client through a request-response architecture.Last updated -Python
- -securityAlicense-qualityA Python implementation of the Model Context Protocol that allows applications to provide standardized context for LLMs, enabling creation of servers that expose data and functionality to LLM applications through resources, tools, and prompts.Last updated -PythonMIT License