Revit MCP Server

MCP server for Autodesk Revit 2024/2025/2026 via pyRevit — 45 tools for building design, editing, analysis, MEP, interop, and documentation.

Works with any MCP client: Claude Desktop, Claude Code, Cursor, Windsurf, Copilot, or any other MCP-compatible application.

How It Works

AI Client ──stdio/SSE/HTTP──> MCP Server (Python/FastMCP) ──HTTP :48884──> pyRevit Routes ──> Revit API

The MCP server runs on your machine and communicates with Revit through pyRevit's Routes API. Any MCP-compatible AI client can connect to it.

Prerequisites

Requirement	Details
Windows 10/11	Revit is Windows-only
Autodesk Revit	2024, 2025, or 2026
pyRevit	Installed and loaded in Revit
uv	Python package manager (install)
A project open in Revit	Tools require an active document

Install pyRevit (if not already installed)

pyRevit is a free add-in that lets scripts run inside Revit. This MCP server needs it to communicate with Revit.

1. Go to https://github.com/pyrevitlabs/pyRevit/releases
2. Download the latest .exe installer (e.g. pyRevit_CLI_x.x.x.x_admin_signed.exe)
3. Run the installer — accept all defaults, click Next through each screen
4. Open (or restart) Revit — you should see a pyRevit tab in the ribbon at the top
5. In the pyRevit tab, click Settings (gear icon)
6. In the Settings window, go to the Routes section on the left
7. Check the box to Enable Routes Server
8. Click Save Settings and let pyRevit reload

To verify: open a browser and go to http://localhost:48884/ — you should see a response (not a "connection refused" error).

Quick Start

Step 1: Clone and install

git clone https://github.com/Demolinator/revit-mcp-server.git
cd revit-mcp-server
uv sync

Step 2: Install the pyRevit extension

The revit_mcp/ folder and startup.py need to run inside Revit via pyRevit.

Option A — Install from pyRevit (recommended):

1. In Revit, go to pyRevit tab > Extensions
2. Find "MCP Server for Revit Python" > Install
3. Wait for pyRevit to reload

Option B — Manual install:

1. Copy the entire repo folder to %APPDATA%\pyRevit\Extensions\
2. Rename the folder to mcp-server-for-revit-python.extension
3. In Revit, go to pyRevit tab > Settings > Custom Extensions
4. Add the path to the .extension folder
5. Reload pyRevit (or restart Revit)

Step 3: Activate pyRevit Routes

1. In Revit, go to pyRevit tab > Settings
2. Navigate to Routes > activate Routes Server
3. pyRevit will start listening on http://localhost:48884/

Step 4: Verify connection

Open a browser and go to:

http://localhost:48884/revit_mcp/status/

You should see:

{
  "status": "active",
  "health": "healthy",
  "revit_available": true,
  "document_title": "your_project_name",
  "api_name": "revit_mcp"
}

Step 5: Start the MCP server

uv run main.py

That's it. Your AI client can now connect.

Connecting Your AI Client

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "revit": {
      "command": "uv",
      "args": ["run", "main.py"],
      "cwd": "/path/to/revit-mcp-server"
    }
  }
}

Cursor / Windsurf / Other MCP Clients

Use HTTP transport:

uv run main.py --streamable-http

Then configure your client to connect to http://localhost:8000/mcp.

Transport Modes

Flag	Transport	Endpoints	Use Case
(none)	stdio	stdin/stdout	Claude Desktop / Claude Code
--sse	SSE	/sse, /messages/	Legacy clients
--streamable-http	HTTP	/mcp	HTTP-based clients
--combined	Both	All above	Maximum compatibility

Testing with MCP Inspector

mcp dev main.py

Then open http://127.0.0.1:6274 in your browser.

Supported Tools (45)

Create (15)

Tool	Description
create_level	Create new levels with elevations
create_line_based_element	Create walls, beams, and other line-based elements
create_surface_based_element	Create floors, roofs, and surface elements
place_family	Place a family instance at specified location
create_grid	Create column grid lines
create_structural_framing	Create structural beams and framing
create_sheet	Create new drawing sheets
create_schedule	Create schedules with custom fields
create_room	Create rooms at specified levels
create_room_separation	Create room separation boundary lines
create_duct	Create ducts between two points (MEP)
create_pipe	Create pipes between two points (MEP)
create_mep_system	Create mechanical or piping systems
create_detail_line	Create view-specific detail lines
create_view	Create floor plans, sections, elevations, 3D views

Query (12)

Tool	Description
get_revit_status	Check if the API is active and responding
get_revit_model_info	Get model information
list_levels	Get all levels with elevations
list_families	Get available family types
list_family_categories	Get all family categories
get_revit_view	Export a view as an image
list_revit_views	List all exportable views
get_current_view_info	Get active view details
get_current_view_elements	Get elements in current view
get_selected_elements	Get currently selected elements
list_category_parameters	List parameters for a category
get_element_properties	Get all parameters and properties of an element

Modify (8)

Tool	Description
delete_elements	Delete elements from the model
modify_element	Modify element parameter values
color_splash	Color elements by parameter values
clear_colors	Reset element colors
tag_walls	Tag all walls in current view
set_parameter	Set a single parameter value on an element
tag_elements	Tag specific elements with annotation symbols
transform_elements	Move, copy, rotate, or mirror elements
set_active_view	Switch the active view in Revit

Analyze (4)

Tool	Description
ai_element_filter	Filter elements by category and parameters
export_room_data	Export room areas, volumes, boundaries
get_material_quantities	Material takeoff data
analyze_model_statistics	Element counts and model stats

Document (3)

Tool	Description
create_dimensions	Create dimension annotations
export_document	Export views to PDF or image

Interop (2)

Tool	Description
export_ifc	Export model to IFC format (IFC2x3/IFC4)
link_file	Link or import DWG, DXF, DGN, or RVT files

Advanced (1)

Tool	Description
execute_revit_code	Execute IronPython code in Revit context

Architecture

Two runtimes communicate over HTTP:

Component	Runtime	Location	Purpose
main.py + tools/	Python 3.11+ (CPython)	Your machine	MCP protocol, tool definitions
startup.py + revit_mcp/	IronPython 2.7 (inside Revit)	Revit process	pyRevit route handlers, Revit API

Multi-Version Revit Support

This server supports Revit 2024, 2025, and 2026 through centralized helper functions that handle the ElementId API differences across versions:

• get_element_id_value() — Extracts integer IDs using .Value (2024+) with .IntegerValue fallback
• make_element_id() — Creates ElementIds using System.Int64 (2024+) with int fallback

No configuration needed — version detection is automatic via try/except at runtime.

Unit Handling

All tools accept millimeters (mm). The server converts to Revit's internal feet.

From	To mm
meters	x 1000
feet	x 304.8
inches	x 25.4

Creating Your Own Tools

Adding a new tool requires 2 files + 2 registration lines:

1. Route handler in revit_mcp/new_module.py (IronPython 2.7)
2. Tool definition in tools/new_tools.py (Python 3.11+)
3. Register routes in startup.py
4. Register tools in tools/__init__.py

See LLM.txt for full context that helps AI assistants understand the codebase.

Contributing

Contributions are welcome! Feel free to submit pull requests or open issues.

Author

Talal Ahmed

License

MIT