5 min read Updated Jan 2026

Revit MCP Documentation

Complete guide to installing, configuring, and using Revit MCP to connect AI desktop applications like Claude Desktop and Cursor to Autodesk Revit via Model Context Protocol.

Supported Revit Versions

• Revit 2022
• Revit 2023
• Revit 2024
• Revit 2025
• Revit 2026

AI Applications

• Claude Desktop
• Cursor

Installation

Enabling the MCP Connector

After installation, click the Revit MCP button in the Add-Ins tab to open the connector dialog. Toggle Enable MCP to start the connection.

The dialog shows the status of detected AI applications:

• Ready (Running) - The AI application is detected and the MCP server is active
• Not Detected - The AI application is not currently running

Configuration

Revit MCP includes one-click auto-configuration for supported AI applications. Click the Revit MCP button in the Add-Ins tab to open the configuration dialog.

Claude Desktop

Click Configure Claude Desktop to automatically update your Claude Desktop configuration. The config file is located at:

Cursor

Click Configure Cursor to automatically update your Cursor MCP configuration. The config file is located at:

Document & Session Tools

These tools provide information about the current Revit session and document.

Tool	Description
ping	Test connection to Revit
get_session_info	Get Revit version, username, memory usage
get_document_info	Get document title, path, project info, phases
get_document_warnings	Get all document warnings with severity filter
get_linked_files	Get linked RVT, CAD, IFC files

Element Query Tools

Query and retrieve information about elements in the Revit model.

Tool	Description
get_elements	Query elements by category, family, type, level
get_element_by_id	Get detailed element info by ID
get_element_parameters	Get all parameters for an element
get_element_count	Count elements by category
get_bounding_boxes	Get bounding box coordinates
get_material_layers	Get material layers of compound elements
get_element_history	Get worksharing history (creator, owner, last modified by)
analyze_delete_impact	Check what depends on elements before deletion
get_element_overrides	Get view-specific graphic overrides

View Tools

Tools for working with views, sheets, and visibility settings.

Tool	Description
get_views	List views (floor plans, sections, elevations, 3D, etc.)
get_active_view	Get current active view details
set_active_view	Switch active view by ID or name
get_current_view_elements	Get visible elements in active view
get_sheets	List all sheets with viewport info
get_schedules	List all schedules with row/column counts
get_view_types	Get available view types
get_view_filters	Get filters applied to a view
hide_isolate_elements	Hide, isolate, or reset element visibility
zoom_to_element	Zoom view to show an element

Selection Tools

Tool	Description
get_selected_elements	Get currently selected elements
select_elements	Set selection by element IDs
clear_selection	Clear current selection
select_warning_elements	Select elements from document warnings
select_imported_cad	Select imported CAD files
select_model_in_place	Select model-in-place (in-place family) elements
save_selection_set	Save current selection as a named set
recall_selection_set	Recall, list, or delete selection sets

Family Tools

Tool	Description
get_categories	Get all categories
get_families	Get loaded families by category
get_family_types	Get types for a family
get_system_types	Get system family types (walls, floors, etc.)
get_family_sizes	Get family file sizes (find bloated families)

Project Tools

Tools for accessing project-level information.

Tool	Description
get_levels	Get all levels with elevations
get_grids	Get all grids
get_phases	Get project phases
get_worksets	Get worksets (workshared docs)
get_rooms	Get rooms with area, volume, boundaries
get_room_boundaries	Get room boundary curves
get_project_units	Get project unit settings

Schedule Tools

Tool	Description
get_schedules	List all schedules
get_schedule_data	Get schedule data as structured JSON

Utility Tools

Tool	Description
calculate	Math calculations

Troubleshooting

Connection Issues

If Claude Desktop or Cursor cannot connect to Revit:

• Ensure Revit is running and has a document open
• Restart your AI application after configuring
• Check that the Bridge executable is not blocked by antivirus
• Try running the ping tool to test connectivity

Tools Not Appearing

If MCP tools are not visible in your AI application:

• Verify the configuration file was updated correctly
• Restart your AI application completely (not just refresh)
• Check the MCP server logs for errors

Frequently Asked Questions

Changelog