5 min read Updated July 2026

MCP Connector Pro Documentation

Complete guide to installing, configuring, and using MCP Connector Pro - 170+ MCP tools across 10 packs, including the 36 free read-only tools, driven by Claude Desktop, Cursor, or Claude Code.

Supported Revit Versions

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

AI Applications

• Claude Desktop
• Cursor
• Claude Code

Installation

Enabling MCP Connector Pro

After installation, click the MCP Connector button in the Add-Ins tab to open the connector dialog. Input your licence key and then 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

MCP Connector Pro includes one-click auto-configuration for supported AI applications. Click the MCP Connector Pro 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:

Claude Code & other MCP clients

MCP Connector Pro exposes a standard MCP stdio server, so it also works with Claude Code and any other MCP-compatible client. Point your client at the MCP Connector Pro server command shown in the connector dialog.

Claude Desktop Settings

MCP Connector Pro exposes 170+ tools. In Claude Desktop, enable Load tools when needed so tools are loaded on demand rather than all at once.

Operator Skill

MCP Connector for Revit ships with a free operator skill - a plain text playbook Claude reads before touching your model. It teaches Claude to use the connector efficiently: read in bulk instead of one element at a time, verify answers with counts, batch edits in one call, and say so instead of guessing when something cannot be done. The result is fewer calls, fewer dead chats, and far less of your usage allowance burned on a single question.

Install in Claude Desktop:

1. Download the skill: revit-connector.zip
2. In Claude Desktop, go to Settings > Skills > Add > Upload a skill and select the zip.
3. That is it - Claude picks the skill up automatically in new chats. If you ever find it has not, mention it in your prompt, for example "Follow the revit-connector skill".

Using Claude Code or Cursor instead? Install steps for both are in the mcp-connector-skills repository, which also hosts free skills for the rest of the MCP Connector family.

Pro Tool Packs

MCP Connector Pro adds 170+ MCP tools across 10 packs, including the 36 free read-only tools. Every tool name shown is the exact identifier exposed to your AI client.

Annotation Pack

Place and manage dimensions, tags, and text across one view or many - then audit them for clashes.

Tool	Description
align_annotations	Align or distribute tags, text notes, and dimensions in the active view to the selection bounds.
auto_dimension_grids	Auto-create linear dimension strings for orthogonal grids across plan and elevation views, with segment and overall dimensions.
auto_dimension_levels	Auto-create vertical dimension strings for levels in elevation views, placed on either side and excluding interior elevations.
auto_dimension_openings	Set out windows and doors along exterior facade walls with plan dimension strings - to each opening's structural jambs (or centrelines), plus the wall ends and an optional overall span.
auto_dimension_rooms	Dimension each room from its two longest walls - a width and a length string, inside or outside the room, breaking out the doors, windows, and openings by their jambs, with an optional overall total. Angled walls ignored.
check_annotation_clashes	Detect overlapping dimensions, tags, and text notes, and optionally auto-reposition clashing tags to resolve overlaps.
create_dimensions	Create linear dimensions in a view between element references or between two explicit points.
create_text_style	Create a text note type by duplicating an existing one and setting its graphics - font, size, bold/italic/underline, width factor, colour, and background.
get_dimension_types	List dimension types in the document, optionally filtered by style, returning ID, name, and style type.
remove_annotations_in_view	Delete dimensions, tags, and text notes from one or more views, with session-only scoping and dry-run preview.
remove_empty_tags	Delete tags whose displayed text is blank - the tag-all leftovers where the tagged parameter is empty - from one view or many, with dry-run preview and the tagged element reported for each.
tag_elements_in_view	Tag every instance of selected categories - rooms, doors, windows, walls, equipment, and more - across one or more views.
toggle_grid_bubbles	Show, hide, or toggle grid bubble heads per end and per view, addressed by screen position or grid end label.

Views & Sheets Pack

Build out the documentation set - create views and sheets, place and align viewports, manage templates, scope boxes, and sheet sets.

Tool	Description
adjust_viewport_title_line	Adjust viewport title-line length to match the title text width or a fixed length across sheets.
align_viewports	Align viewport positions across target sheets to match a chosen reference sheet.
analyze_linked_view_usage	Audit RVT link display across views - which views show a link By Linked View or Custom, and which view from the linked model is displayed. (Revit 2024+)
analyze_visibility	Diagnose why elements are not visible in a view, checking categories, filters, phases, view range, and more.
apply_scope_box	Apply a scope box to specified views so their crop follows the box.
apply_view_template	Apply or remove a view template across specified views, view types, or name-matched views.
batch_fill_sheet_parameters	Set parameters across multiple sheets using literals, formulas, view-derived values, and scale calculations.
capture_view	Capture the active or named view as a PNG image so a vision-capable AI can inspect the model.
copy_view_filter	Copy view filters and their graphic overrides from a source view to target views.
copy_view_setup	Copy scale, template, detail level, display style, discipline, phase, and crop from one view to others.
create_assembly_views	Generate the standard view set - 3D, detail sections, part list, and per-category schedules - for an assembly, optionally on an assembly sheet.
create_batch_sheets	Create multiple sheets in bulk with auto-incrementing numbers, prefixes, suffixes, and zero-padding.
create_element_sections	Create front, back, left, right, and top section views oriented to selected elements.
create_room_elevations	Create interior elevations, 3D views, plans, and RCPs for selected rooms, optionally laying them out on sheets.
create_scope_box	Create a scope box by duplicating an existing one (optionally offset and renamed), or at exact dimensions from an origin and width/depth/height or min/max corners.
create_section_by_room	Auto-create longitudinal and transverse section views centred on each selected room.
create_sheets	Create one or more sheets with a title block, optionally placing views at given positions.
create_sheets_from_excel	Create sheets in bulk from a drawing-register .xlsx - sheet number, name, title block, and optional view and scale per row - in one pass, with a dryRun preview.
create_view_filter	Create a named rule-based view filter from categories and parameter rules (equals, contains, greater, less, has value...), combined with AND or OR, optionally applied to views with visibility and graphic overrides.
create_view_template	Create a named view template from an existing view - captures its visibility, filters, scale, and detail level - and optionally assign it to views.
create_views	Create floor plans, reflected ceiling plans, and 3D views with level, scope box, scale, and template options.
delete_sheets	Delete sheets by name or number (or all except a keep-list), preserving the active sheet.
delete_views	Delete views, by default keeping views placed on sheets and the active view; templates and schedules optional.
duplicate_sheets	Duplicate existing sheets, optionally copying their views onto the new sheets.
get_active_view	Get current active view details
get_current_view_elements	Get visible elements in active view
get_scope_boxes	List scope boxes with their extents and optionally the views each is applied to.
get_sheets	List all sheets with viewport info
get_title_block_info	List project, sheet, and title block parameters usable as naming placeholders in export tools.
get_view_filters	List view filters applied to a view, with their visibility state, graphic overrides, and rules.
get_view_types	List view family types, levels, title blocks, scope boxes, and existing view names for the project.
get_views	List views (floor plans, sections, elevations, 3D, etc.)
hide_isolate_elements	Hide, isolate, or reset element visibility
layout_sheet_viewports	Rearrange existing viewports on a sheet using grid, row, column, or auto layouts to avoid overlaps.
manage_sheet_sets	Manage sheet sets: list, create, delete, rename, add or remove sheets, and export to PDF.
orient_view_to_elements	Orient and zoom the active 3D view onto specified elements, setting a section box around them. Set orientToFace with a wall or face to rotate the section box square-on (parallel) to it, fitted around the element.
override_element_graphics	Apply graphic overrides (colour, line weight, transparency, halftone) to elements in a view, colour-code elements by a parameter's value with an auto legend, or clear overrides.
place_views_on_sheets	Place views on sheets with auto-layout that sizes viewports to prevent overlaps.
remove_scope_box	Clear a scope box from views or delete the scope box element from the model.
rename_views	Rename views by stripping copy/duplicate suffixes or rewriting from a per-view-type naming template.
renumber_sheets	Renumber sheets with a prefix and a zero-padded incrementing sequence, ordered by current number or name.
renumber_viewport_detail_numbers	Renumber viewport detail numbers with zero-padding, ordered by position, name, or existing number.
reset_temporary_hide_isolate	Reset temporary hide/isolate state in the active view
set_active_view	Switch active view by ID or name
standardize_view_templates	Assign a view template to many views at once, matched by view type, name substring, or explicit view IDs.
unhide_elements_in_view	Clear the permanent per-view element hide override (Hide in View, Elements) so hidden elements show again - specific elementIds, or every hidden element in the view.

Modelling Pack

Author core building geometry from coordinates and room boundaries - grids, levels, floors, roofs, ceilings, finishes, and skirting.

Tool	Description
auto_place_rooms	Auto-place rooms in every enclosed region on the given levels, skipping regions that already have a room.
copy_element	Copy an element by a translation vector, optionally producing multiple equally spaced copies.
create_ceiling	Create a ceiling from a closed polygon of boundary points on a chosen level and ceiling type.
create_ceilings_from_rooms	Create ceilings inside selected rooms from their boundaries, set at a height offset above each room's level.
create_floor	Create a floor from a closed polygon of boundary points on a chosen level and floor type.
create_grids	Create horizontal and vertical grid lines with named labels, uniform or variable spacing, and a chosen origin.
create_levels	Create levels at given elevations, optionally auto-generating each level's floor plan view.
create_mass_floors	Assign mass floors to placed conceptual masses at chosen levels so area and volume schedules populate.
create_roof	Create a footprint roof from a closed polygon of boundary points on a chosen level and roof type.
create_toposolid_from_dwg	Create a Toposolid from a linked CAD survey - reads 3D contours and survey points, or numeric spot-height labels, straight from the DWG/DXF (with the survey's own units: m, mm, ft and more), positioned by matching the file to the link, with layer filtering and a dry-run placement check. Toposolid on Revit 2024+, topography surface on older versions.
create_room_finishes	Create floor and wall finishes inside rooms from their boundaries, with optional joining to structural walls.
get_grids	Get all grids
get_levels	Get all levels with elevations
get_room_areas	Get room area summary grouped by level, department, or room name
get_room_boundaries	Return a room's boundary loops and segments with start/end points, lengths, and bounding element details.
get_rooms	Get rooms with area, volume, boundaries
get_wall_sweep_types	List available wall sweep types (cornices) for skirting, baseboards, and mouldings, with ID, name, and family.
place_skirting_in_rooms	Place wall-sweep skirting along the base of room-bounding walls on the interior face, cut at openings.
ungroup_elements	Ungroup model or detail group instances, releasing their members in place.

Data Pack

Read and write element parameters at scale, with full Excel round-trip and intelligent renumbering.

Tool	Description
batch_modify_by_filter	Find elements by category and parameter rules, then write parameter values to every match.
batch_set_parameters	Set one parameter to the same value across many elements in a single transaction, reporting per-element results.
clear_selection	Clear current selection
export_parameters_to_excel	Export element parameters to an .xlsx file, one row per element, ready for editing and re-import.
find_replace_parameter	Find and replace text parameter values across a category using exact, contains, starts/ends-with, or regex modes.
get_categories	Get all categories
get_element_by_id	Get detailed element info by ID
get_element_count	Count elements by category
get_element_parameters	Get all parameters for an element
get_element_set	List the ElementIds behind an element set handle (ES-xxxx) returned by get_elements or search_elements; paginated.
get_elements	Query elements by category, family, type, level
get_families	Get loaded families by category
get_family_types	Get types for a family
get_parameter_values_by_category	Read a specific parameter value across all elements in a category
get_parameters_for_category	List parameters on a category's elements with name, storage type, and instance/type level, for discovering valid names.
get_selected_elements	Get currently selected elements
import_parameters_from_excel	Write parameter values from an .xlsx file onto elements matched by an ElementId column, skipping blanks and read-only fields.
match_element_properties	Copy parameter values from a source element to target elements - all writable parameters or a named subset.
recall_selection_set	Recall, list, or delete selection sets
renumber_elements	Renumber elements by view reading order, selection, or path, with level/building prefixes and zero-padding.
save_selection_set	Save current selection as a named set
search_elements	Search for elements by text across names, type names, family names, marks, and comments
select_elements	Set selection by element IDs
set_parameter	Set one parameter value on a single element, auto-detecting storage type and rejecting read-only parameters.

Reporting Pack

Manage revisions and the drawing register, run quantity and finish takeoffs, compare elements, and produce analysis reports.

Tool	Description
add_revision_to_sheets	Add one or more revisions to selected sheets, by sheet number, ID, or all sheets.
analyze_drawing_register	Read a company drawing register / issue sheet template (.xlsx) and detect its header row and column layout, ready for update_drawing_register.
compare_elements	Compare two or more elements side-by-side, showing parameter differences, matching values, and type variations.
create_revision	Create a new revision row in the Sheet Issues/Revisions table with description, date, issuer, visibility, and numbering sequence.
export_drawing_register	Write sheet and revision data to an .xlsx drawing register - simple one-row-per-sheet list format, into a template workbook or a new workbook.
export_warnings_report	Export model warnings to a CSV or JSON health-check report with descriptions, counts, severity, and affected element IDs.
get_material_quantities	Aggregate material volume and area across model elements for takeoff, filtered by category or material and grouped flexibly.
get_revision_settings	Report revision settings and available numbering sequences to find the correct sequence ID before creating revisions.
get_revisions	List all revisions in the document with sequence number, date, description, and issued status.
get_room_finishes	Report room finish data including wall, floor, and ceiling finishes, bounding elements, and contained furniture counts.
get_schedule_data	Get schedule data as structured JSON
get_schedules	List all schedules
get_sheet_revisions	List sheets with their assigned revisions and current revision details, for drawing issue registers.
remove_revision_from_sheets	Remove a revision from selected sheets, optionally deleting associated revision clouds and the revision itself.
update_drawing_register	Fill a matrix-style drawing issue sheet (one row per drawing, one column per revision with date headers) from sheet and revision data, using your company's own .xlsx template - the AI maps the columns, no fixed layout assumed.

Model Management Pack

Audit, purge, compact, and maintain model health - plus worksharing, links, design options, and file operations.

Tool	Description
assign_elements_to_worksets	Move model elements onto a target workset by explicit IDs, category, level, or current selection; creates the workset if new.
audit_model_health	Run a full model health audit: warnings, element counts by category, unplaced rooms, unused families, imported CAD, and file metrics.
batch_link_cad	Link every CAD file (DWG, DXF, DGN) in a folder into the model with shared import settings.
calculate	Math calculations
close_document	Close the active document, optionally saving first and optionally exiting Revit afterwards.
compact_model	Save the model with compaction to reduce file size, reporting before and after sizes; optionally save the compacted copy elsewhere.
create_workset_views	Create a 3D view per workset, isolating each workset's visibility, in workshared models.
delete_unplaced_rooms_areas_spaces	Delete unplaced, unenclosed, or redundant rooms, areas, or MEP spaces.
enable_worksharing	Convert a non-workshared model to workshared, creating a grids/levels workset and a default workset.
get_design_options	List every design option set in the model, showing each set's options and which is primary.
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
get_phases	Get project phases
get_project_units	Get project unit settings
get_session_info	Get Revit version, username, memory usage
get_worksets	Get worksets (workshared docs)
manage_links	Load, unload, reload, remove, or repath linked Revit models, in batches across multiple links.
manage_worksets	Create, rename, or delete worksets in a workshared model, supporting multiple operations in one call.
open_model	Open a model from cloud (ACC/BIM 360) or local/network path, with options to detach, audit, unload links, and guard against version upgrades.
ping	Test connection to Revit
prune_design_options	Delete all non-primary design options and their elements, preserving primary geometry with original IDs.
purge_unused	Purge unused families, types, view templates, filters, materials, patterns, and imported CAD in iterative passes; supports dry-run.
relinquish_all	Relinquish ownership of all worksets and elements without syncing, for detached models saved as a new central.
remove_links	Remove linked files (Revit links, CAD links, or both), unloading and deleting the link types and all their instances.
remove_unused_view_templates	Delete view templates that no view references, filling the gap purge_unused leaves.
rename_families	Rename families and family types using search-and-replace rules, with scope, type-inclusion, case-sensitivity, and preview options.
save_as	Save the active document to a new path, with options for maximum backups, compaction, clearing the transmitted flag, and disabling worksharing.
set_link_path_type	Switch linked Revit models' reference path between absolute and relative in bulk.
sync_and_relinquish	Synchronise a workshared model with central and optionally relinquish all worksets, with comment and compaction options.

Warnings Pack

Automated resolvers for Revit's most common warning types - fix every warning matching a pattern in a single call.

Tool	Description
resolve_duplicate_instances	Fix identical-instances-in-the-same-place warnings by deleting duplicates, keeping either the original or the newest element.
resolve_duplicate_marks	Fix duplicate instance Mark warnings by clearing or renumbering marks, with filters, patterns, and batched processing.
resolve_duplicate_type_marks	Fix duplicate Type Mark warnings by clearing or renumbering type marks, with configurable patterns and numbering scope.
resolve_joined_not_intersecting	Fix joined-but-do-not-intersect warnings by unjoining the highlighted elements.
resolve_multiple_areas_same_region	Fix multiple-areas-in-the-same-enclosed-region warnings by selecting or deleting redundant areas by a chosen rule.
resolve_multiple_rooms_same_region	Fix multiple-rooms-in-the-same-enclosed-region warnings by selecting or deleting redundant rooms by a chosen rule.
resolve_off_axis_area_boundary	Fix 'Area Boundary line is slightly off axis' warnings by snapping to clean angles.
resolve_off_axis_grids	Fix 'Grid is slightly off axis' warnings by snapping grids to clean angles.
resolve_off_axis_lines	Fix 'Line is slightly off axis' warnings for model and detail lines.
resolve_off_axis_reference_planes	Fix 'Reference Plane is slightly off axis' warnings.
resolve_off_axis_room_separation	Fix 'Room separation line is slightly off axis' warnings.
resolve_off_axis_sketch_lines	Fix 'Line in Sketch is slightly off axis' warnings in floor, ceiling, and wall sketches.
resolve_off_axis_walls	Fix 'slightly off axis' wall warnings by snapping walls to the nearest clean angle.
select_warning_elements	Select and isolate elements that have warnings, optionally creating a dedicated 'Warnings Review' 3D view, filterable by warning type.

Coordination Pack

Run clash detection between disciplines and linked models, manage MEP penetrations, and set up dedicated review views.

Tool	Description
check_model_interferences	Detect clashes between two sets of element categories and report each clashing pair with its location.
create_clash_review_view	Create or return a dedicated isometric 3D 'Clash Review' view and return its ID.
create_mep_openings	Place rectangular or circular opening family instances at penetration locations, sized automatically.
cut_mep_openings	Cut native rectangular openings directly into wall and floor hosts at penetration points, without placing a family.
detect_mep_penetrations	Detect MEP services from linked models penetrating walls, floors, ceilings, and roofs, grouping them into sized openings.
export_clash_report	Write clash results to a CSV file and return the row count and written path.
get_bounding_boxes	Return min, max, centre, and dimensions of element bounding boxes in millimetres, optionally view-specific.
get_elements_by_proximity	Find elements within a radius of a point or element, returning them sorted by distance with an optional category filter.

Issue Pack

Export the model for sharing, handover, or coordination - PDF, DWG, IFC, NWC, images, and data, with parameter-based naming.

Tool	Description
export_dwg	Export views or sheets to DWG or DXF with layer mapping standards, line scaling, units, and property overrides.
export_ifc	Export the model to IFC with full option coverage: version, property sets, mapping tables, and header metadata.
export_nwc	Export the model to NWC for Navisworks with full option coverage, including scope, conversion, and faceting controls.
export_pdf	Export sheets to PDF with parameter-based naming, colour and quality controls, and an optional single combined file.
export_room_data	Export rooms with chosen parameters to CSV or JSON, filtered by level or phase; returns inline if no path is given.
export_schedule	Export a schedule view to a CSV file, optionally including column headers.
export_view_image	Export a view to a PNG or JPG image at a chosen pixel size and quality.

Selection Pack

Pin and unpin elements to lock down or release your selection.

Tool	Description
pin_selection	Pin the selected elements (or a passed elementIds set) so they can't be moved or accidentally deleted. Skips already-pinned, reports un-pinnable elements, and previews with dryRun.
unpin_selection	Unpin the selected elements (or a passed elementIds set) so they can be moved or edited again. Previews with dryRun.

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

Claude Desktop may need to be restarted by closing it in the system tray, then reopening it.

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
• Check the bridge is running in Claude Desktop

Frequently Asked Questions

Changelog