revit-ai-native
Provides tools for interacting with Autodesk Revit 2024, enabling AI agents to inspect documents and selections, query elements, create and modify walls, doors, windows, rooms, manage views and sheets, and execute parameter changes within transactional plans.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@revit-ai-nativeWhat walls are selected in the current Revit document?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Autodesk Native Agent Runtime for Revit 2024
A production-grade bridge between AI agents (Antigravity, Claude, etc.) and Autodesk Revit 2024, built on the Model Context Protocol (MCP).
Architecture
Antigravity / AI Agent
↓ (MCP over stdio)
MCP Server (TypeScript, Node.js)
↓ (Named Pipe, JSON envelopes)
Revit 2024 Add-in (.NET Framework 4.8)
↓ (ExternalEvent)
Main-thread Dispatcher → PlanExecutor
↓ (TransactionGroup)
Revit API (Document, Wall, FamilyInstance, ...)
↓ (Verification + Assertions)
Structured Result → MCP ResponseRelated MCP server: Revit MCP Server
Quick Start
1. Prerequisites
Revit 2024 installed (required for add-in build)
.NET SDK (for building C# projects)
Node.js 18+ (for MCP TypeScript server)
PowerShell (for build/install scripts)
2. Set REVIT_2024_PATH
If Revit is not in the default location (C:\Program Files\Autodesk\Revit 2024), set the environment variable:
$env:REVIT_2024_PATH = "D:\REVIT\2024\Revit 2024"3. Build
.\scripts\build-all.ps14. Install Add-in
.\scripts\install-revit2024.ps15. Open Revit 2024
Open or create a Revit project. The add-in starts the named-pipe server automatically.
6. Start MCP Server
.\scripts\start-mcp.ps17. Configure Antigravity
Add the MCP server to your Antigravity configuration:
{
"mcpServers": {
"revit": {
"command": "node",
"args": ["e:\\revit-A.I Native\\apps\\agent-mcp\\dist\\index.js"]
}
}
}8. Get Status
Call revit_get_status from your agent. You should see:
{
"connected": true,
"activeDocumentTitle": "YourProject.rvt",
"busy": false
}9. Preview a Plan
Send a plan to revit_preview_plan:
{
"schemaVersion": "1.0",
"requestId": "test-001",
"description": "Create a 5000mm wall",
"document": { "strategy": "active_document" },
"units": "mm",
"coordinateSystem": "project",
"executionMode": "preview",
"operations": [...],
"safety": { "requireUserConfirmation": true }
}10. Approve & Commit
Call revit_commit_plan with the same plan. If confirmation is required, approve in Revit.
11. Inspect Audit Log
Audit logs are at %LOCALAPPDATA%\AutodeskNativeAgent\logs as JSONL files.
Supported Operations
Operation | Status |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
| ✅ Supported |
MCP Tools
Tool | Description |
| Connection status and document info |
| Protocol version, methods, operations |
| Active document identity |
| Current selection |
| Structured element query |
| Validate without executing |
| Dry-run resolution |
| Execute in a transaction |
| Job status and result |
| Cancel queued/running job |
| Rollback completed job |
| Sanitized audit entries |
Key Design Decisions
No Revit API from background threads — All Revit API calls go through the ExternalEvent dispatcher
Atomic execution — Plans run inside a single TransactionGroup; failures roll back
Structured errors — Every failure carries a stable error code
Unit safety — All lengths carry explicit units; no hardcoded
/ 304.8Type safety — Type/level resolution is deterministic; no random
FirstElement()Path security — Export/SaveAs paths are canonicalized and checked for traversal
Confirmation tokens — Destructive operations require human approval
Documentation
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Let AI agents query data and act across all your business apps via MCP.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Related MCP Servers
- AlicenseAqualityFmaintenanceAllows AI to interact with Autodesk Revit via the MCP protocol, enabling retrieval of project data and automation of tasks like creating, modifying, and deleting elements.1365 npm458MIT
- AlicenseBqualityNot gradedmaintenanceAllows AI assistants to interact with Autodesk Revit through the MCP protocol, enabling the AI to create, modify, and delete elements in Revit projects.1565 npm1-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Autodesk Revit to query project data, manage elements, and execute generated code via the Model Context Protocol. It provides full compatibility with GitHub Copilot and Claude to automate BIM modeling workflows.1365 npmMIT
- AlicenseNot gradedqualityAmaintenanceMCP server for Autodesk Revit (BIM) with 705+ API endpoints. Enables AI agents to create walls, place doors/windows, generate sheets, manage views, and produce construction documents via the Model Context Protocol. Uses named pipes for zero-crash Revit integration.22MIT