Autodesk Revit

v1.0.0Browser Automationstable

Sample MCP server to automate Revit via Automation API using SSA

apsautomation-apimcpmcp-serverrevit
Share:
8
Stars
0
Downloads
0
Weekly
0/5

What is Autodesk Revit?

Autodesk Revit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to sample mcp server to automate revit via automation api using ssa

Sample MCP server to automate Revit via Automation API using SSA

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Sample MCP server to automate Revit via Automation API using

Use Cases

Automate Revit designs using Autodesk Platform Services.
Control BIM authoring tasks remotely through AI.
LicenseMIT
Languagec#
Versionv1.0.0
UpdatedMay 3, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx aps-sample-mcp-server-revit-automation

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Autodesk Revit

The APS Sample MCP Server for Revit Automation demonstrates how to control Autodesk Revit models programmatically through the Autodesk Platform Services (APS) Automation API using Server-to-Server authentication. It exposes MCP tools to create new Revit models from templates and link existing models together — enabling AI-assisted BIM workflows where Claude can orchestrate Revit operations without requiring a running Revit desktop session.

Prerequisites

  • An Autodesk Platform Services (APS) application with the Automation API enabled, created at https://aps.autodesk.com/
  • .NET 10 SDK installed on the server that will run the MCP server
  • An RSA key pair (private key PEM file) for Server-to-Server (S2S) authentication with APS
  • A Revit AppBundle deployed to APS Design Automation that contains your Revit automation logic
  • Claude Desktop or VS Code with an MCP client extension installed
1

Clone the repository and restore dependencies

Clone the APS sample repository and restore the .NET NuGet packages. The project targets .NET 10 and uses the Autodesk APS SDK packages.

git clone https://github.com/autodesk-platform-services/aps-sample-mcp-server-revit-automation.git
cd aps-sample-mcp-server-revit-automation
dotnet restore
2

Configure APS credentials

Create an appsettings.json file in the project root with your APS application credentials. Obtain ClientId and ClientSecret from the APS Developer Portal. The KeyId and ServiceAccountId come from the S2S credentials you configure in your APS application.

{
  "Forge": {
    "ClientId": "your-aps-client-id",
    "ClientSecret": "your-aps-client-secret",
    "ServiceAccountId": "your-service-account-id",
    "KeyId": "your-key-id",
    "PrivateKeyPath": "/absolute/path/to/private-key.pem"
  }
}
3

Build and run the MCP server

Build the project in Release configuration and start the server. It will listen on port 6223 by default for incoming MCP HTTP connections.

dotnet build --configuration Release
dotnet run

# The server starts on http://localhost:6223
4

Configure your MCP client to connect

Add the server to your MCP client. For VS Code, add the server URL to .vscode/mcp.json. For Claude Desktop, use the HTTP transport type pointing to localhost:6223.

5

Deploy the Revit AppBundle to APS Design Automation

The MCP tools submit work items to APS Design Automation, which requires a companion AppBundle containing the actual Revit automation logic (Revit API add-in). Deploy the AppBundle through the APS Design Automation API or the online viewer before using the create_model or link_models tools.

Autodesk Revit Examples

Client configuration

VS Code MCP client configuration for connecting to the Revit Automation MCP server over HTTP on localhost. Claude Desktop uses the same URL with type 'http'.

{
  "servers": {
    "revit-automation-mcp": {
      "url": "http://localhost:6223",
      "type": "http"
    }
  }
}

Prompts to try

Natural language prompts for automating Revit model creation and model linking through the APS Automation API.

- "Create a new Revit model named 'Office Building' using the default architectural template in the US region"
- "Link the structural model to the architectural model in project abc-123"
- "Create a Revit model from the MEP template and add it to project xyz-456"
- "Remove the link between the coordination model and the architectural model"

Troubleshooting Autodesk Revit

Authentication fails with 401 or 403 errors when submitting work items

Verify that ClientId, ClientSecret, ServiceAccountId, KeyId, and PrivateKeyPath are all correct in appsettings.json. The private key PEM file must be the RSA private key corresponding to the public key registered in your APS S2S application. Also confirm the Automation API is enabled in the APS Developer Portal for your application.

dotnet build fails with SDK version error

This project targets .NET 10. Check your installed SDK version with `dotnet --version`. Download .NET 10 SDK from https://dotnet.microsoft.com/download/dotnet/10.0 and install it. Then retry `dotnet restore && dotnet build --configuration Release`.

Work items are submitted successfully but Revit jobs fail in Design Automation

Check APS Design Automation work item status through the APS API or the online viewer at https://aps.autodesk.com/. Common causes are: the AppBundle is not deployed or the Activity is not configured, the project GUID or model GUID is incorrect, or the service account does not have access to the specified ACC/BIM360 project.

Frequently Asked Questions about Autodesk Revit

What is Autodesk Revit?

Autodesk Revit is a Model Context Protocol (MCP) server that sample mcp server to automate revit via automation api using ssa It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Autodesk Revit?

Follow the installation instructions on the Autodesk Revit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Autodesk Revit?

Autodesk Revit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Autodesk Revit free to use?

Yes, Autodesk Revit is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "aps-sample-mcp-server-revit-automation": { "command": "npx", "args": ["-y", "aps-sample-mcp-server-revit-automation"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Autodesk Revit?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides