Autodesk Revit MCP Server

Model Context Protocol server for Autodesk Revit

Quick Start | API Reference

Overview

Production-ready MCP server enabling AI agents to control Autodesk Revit through natural language. Integrates with Claude Desktop, Microsoft Copilot, and custom MCP clients.

Key Features:

• 100+ Revit API tools (geometry, views, sheets, families, MEP, structures)
• Localhost HTTP bridge with sub-second response time
• Thread-safe ExternalEvent architecture
• Advanced reflection API for unlimited Revit access
• Production-ready with comprehensive tool coverage

Quick Start

Prerequisites

• Windows 10/11
• Autodesk Revit 2024-2026
• Python 3.11+
• .NET Framework 4.8

Installation

# Clone repository
git clone https://github.com/Sam-AEC/Autodesk-Revit-MCP-Server.git
cd Autodesk-Revit-MCP-Server

# Build Revit add-in
.\scripts\build-addin.ps1 -RevitVersion 2024

# Install Python package
pip install -e packages/mcp-server-revit

Configure Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "revit": {
      "command": "python",
      "args": ["-m", "revit_mcp_server.mcp_server"],
      "env": {
        "MCP_REVIT_BRIDGE_URL": "http://127.0.0.1:3000",
        "MCP_REVIT_MODE": "bridge"
      }
    }
  }
}

Configure VS Code / GitHub Copilot

This repository includes a workspace MCP config at .vscode/mcp.json. After installing the Python package and starting Revit with the bridge add-in loaded, open this repository in VS Code and run MCP: List Servers or use the MCP Servers view.

Verify Installation

Start Revit, then:

curl http://localhost:3000/health

Expected response:

{
  "status": "healthy",
  "revit_version": "2024"
}

Architecture

┌─────────────────────────────────┐
│ AI Client (Claude/Copilot)      │
└───────────────┬─────────────────┘
                │ MCP Protocol
┌───────────────▼─────────────────┐
│ MCP Server (Python)             │
│ - Tool Registry                 │
│ - Security/Audit                │
└───────────────┬─────────────────┘
                │ HTTP :3000
┌───────────────▼─────────────────┐
│ Revit Bridge Add-in (C#)        │
│ - HTTP Server                   │
│ - ExternalEvent Handler         │
└───────────────┬─────────────────┘
                │ Revit API
┌───────────────▼─────────────────┐
│ Autodesk Revit 2024-2026        │
└─────────────────────────────────┘

Threading Model: HTTP requests are queued and executed on Revit's main thread via ExternalEvent for thread safety.

Bridge Status: The bridge runs as a localhost HTTP server on port 3000, providing health checks and tool execution endpoints.

Available Tools

Document Management

• revit.create_new_document - Create blank project
• revit.open_document - Open RVT/RFA file
• revit.save_document - Save active document
• revit.close_document - Close document
• revit.get_document_info - Get project metadata

Levels & Grids

• revit.create_level - Create level at elevation
• revit.list_levels - List all levels
• revit.create_grid - Create grid line

Model Elements

• revit.create_wall - Create wall from curve
• revit.create_floor - Create floor from profile
• revit.create_roof - Create roof from profile
• revit.create_column - Cr

... View full README on GitHub