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

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

Testing with MCP Inspector

mcp dev main.py

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

Supported Tools (45)

Create (15)

Query (12)

Modify (8)

Analyze (4)

Document (3)

Interop (2)

Advanced (1)

Architecture

Two runtimes communicate over HTTP:

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.

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