# Horizun Revit MCP

> Horizun Revit MCP is an open-source MCP server for bim and architecture. Drive Autodesk Revit 2023-2027 from an AI client on Windows with a 125-tool catalog. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, self-hosted
- **Website:** https://horizunhub.com
- **Repository:** https://github.com/horizungroup/horizun-revit-mcp
- **MCP Registry name:** io.github.HorizunGroup/horizun-revit-mcp
- **Categories:** bim and architecture
- **Listing updated:** 2026-11-14

## About

The server is a local Windows program paired with Revit add-ins; you run the Windows installer first, then connect a client. The README says the full catalog holds 125 tools and 481 named suboperations covering architectural and structural modelling, MEP, parametric families, drawings, CAD-to-BIM, model audits, quantities, Excel, Power BI and exports. Typed changes include a rehearsal step, explicit targets and verification after commit, and an owner-enabled Python option reaches further into the Revit API.

Version 4.0 is aimed at small models. Because every listed tool is sent to the model in each conversation, a new install starts with a 14-tool essentials profile instead of the full list, cutting the opening tool listing from roughly 105,000 tokens to about 18,100, or about 4,400 with compact schemas. The rest stay reachable through search and call tools, and role profiles such as query, modelling, documentation and audit are available. The authors report Claude Haiku finishing 26 of 27 test tasks with 58 percent fewer input tokens.

It is free and open source, made by Horizun Group in Colombia, which also sells BIM courses and apps; the company site is in Spanish.

## Features

- **Large Revit catalog:** 125 tools and 481 suboperations across modelling, MEP, families, drawings and audits.
- **Tool profiles:** A compact 14-tool profile loads by default; other toolsets open on demand.
- **Compact schemas:** An environment setting shortens descriptions to save tokens for small models.
- **Rehearse and verify:** Typed changes can be rehearsed first and are checked after they commit.
- **Steel and exchange:** Reinforcement rules and an exchange manifest feature are listed under 3.0.
- **Revit 2023 to 2027:** Works with five Revit versions through a Windows installer.

## Good for

- Generate model elements in Revit from a written brief
- Audit a model and pull quantities into Excel or Power BI
- Convert CAD drawings into BIM content
- Run Revit automation with a cheaper or local model

## Install

### Claude Code (Terminal)

```sh
claude mcp add horizun-revit-mcp -- npx -y https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v4.0.1/horizun-revit-4.0.1.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "horizun-revit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v4.0.1/horizun-revit-4.0.1.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "horizun-revit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v4.0.1/horizun-revit-4.0.1.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "horizun-revit-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v4.0.1/horizun-revit-4.0.1.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "horizun-revit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v4.0.1/horizun-revit-4.0.1.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "horizun-revit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v4.0.1/horizun-revit-4.0.1.mcpb"
      ]
    }
  }
}
```

## Tools

- `horizun_list_tools`: Searches the full tool catalog in Spanish or English.
- `horizun_call_tool`: Calls any tool that is not in the active profile.
- `horizun_activate_toolset`: Opens one more toolset for the session.
- `horizun_read_schedule`: Reads vector PDF or DWG schedule cards and refuses ambiguous rows.
- `horizun_exchange`: Emits and verifies exchange manifests.

## FAQ

### Which Revit versions work?

Revit 2023 through 2027, on Windows only.

### Is it free?

Yes. The README describes it as a free, open-source Windows MCP server and Revit add-in.

### How does it handle small models?

Version 4.0 starts with a 14-tool essentials profile and optional compact schemas; other tools are found through horizun_list_tools and horizun_call_tool.

### Can local models drive it?

The README reports qwen3:8b completing 12 of 27 tasks, so simple jobs work but full production is not yet reliable.

### Is Horizun Revit MCP free?

Yes. Horizun Revit MCP is open source, so you can use and self-host it for free.

### How do I add Horizun Revit MCP to Claude Code?

Run this command in your terminal: claude mcp add horizun-revit-mcp -- npx -y https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v4.0.1/horizun-revit-4.0.1.mcpb

---
Source: https://ai-powered.com/mcp/horizun-revit-mcp
