# Model MCP

Connects Autodesk Revit to Claude Code, Codex, Cursor and other MCP clients. Reads the open model, checks it and changes it through prompts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20 repo stars
- Author: sharafutdinovdi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sharafutdinovdi/revit-model-mcp
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/model-mcp

## What it does

The server links a running Revit instance on Windows to an AI client over MCP stdio. The agent gets tools for reading the model (`revit_document_info`, `revit_query_elements`, `revit_list_warnings`), changing it (`revit_place_family`, `revit_move`, `revit_override_graphics`) and running checks (`revit_model_health`, `revit_parameter_fill_check`). Each change is a separate Revit transaction, rolled back with one Undo.

Two-step installation: an MSI add-in inside Revit on Windows, then register the server in Claude Code with `claude mcp add` or through the add-in menu. The PyPI version requires `uv`. Set `REVIT_MCP_READ_ONLY=1` to disable changes and keep read-only access. For Mac and Linux over SSH, configure `REVIT_MCP_HOST` instead of `local`.

Supports Revit 2022–2027. The add-in checks for updates daily unless disabled.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `REVIT_MCP_HOST`, `REVIT_MCP_REDACT_PATHS`, `REVIT_MCP_READ_ONLY`, `REVIT_MCP_TOOLSETS`, `REVIT_MCP_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env REVIT_MCP_HOST=<REVIT_MCP_HOST> --env REVIT_MCP_REDACT_PATHS=<REVIT_MCP_REDACT_PATHS> --env REVIT_MCP_READ_ONLY=<REVIT_MCP_READ_ONLY> --env REVIT_MCP_TOOLSETS=<REVIT_MCP_TOOLSETS> --env REVIT_MCP_TOKEN=<REVIT_MCP_TOKEN> --transport stdio model-mcp -- uvx revit-model-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from revit-model-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add model-mcp --env REVIT_MCP_HOST=<REVIT_MCP_HOST> --env REVIT_MCP_REDACT_PATHS=<REVIT_MCP_REDACT_PATHS> --env REVIT_MCP_READ_ONLY=<REVIT_MCP_READ_ONLY> --env REVIT_MCP_TOOLSETS=<REVIT_MCP_TOOLSETS> --env REVIT_MCP_TOKEN=<REVIT_MCP_TOKEN> -- uvx revit-model-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from revit-model-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "model-mcp": {
            "command": "uvx",
            "args": [
                "revit-model-mcp"
            ],
            "env": {
                "REVIT_MCP_HOST": "<REVIT_MCP_HOST>",
                "REVIT_MCP_REDACT_PATHS": "<REVIT_MCP_REDACT_PATHS>",
                "REVIT_MCP_READ_ONLY": "<REVIT_MCP_READ_ONLY>",
                "REVIT_MCP_TOOLSETS": "<REVIT_MCP_TOOLSETS>",
                "REVIT_MCP_TOKEN": "<REVIT_MCP_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from revit-model-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "model-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "revit-model-mcp"
            ],
            "env": {
                "REVIT_MCP_HOST": "<REVIT_MCP_HOST>",
                "REVIT_MCP_REDACT_PATHS": "<REVIT_MCP_REDACT_PATHS>",
                "REVIT_MCP_READ_ONLY": "<REVIT_MCP_READ_ONLY>",
                "REVIT_MCP_TOOLSETS": "<REVIT_MCP_TOOLSETS>",
                "REVIT_MCP_TOKEN": "<REVIT_MCP_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from revit-model-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e REVIT_MCP_HOST=<REVIT_MCP_HOST> -e REVIT_MCP_REDACT_PATHS=<REVIT_MCP_REDACT_PATHS> -e REVIT_MCP_READ_ONLY=<REVIT_MCP_READ_ONLY> -e REVIT_MCP_TOOLSETS=<REVIT_MCP_TOOLSETS> -e REVIT_MCP_TOKEN=<REVIT_MCP_TOKEN> model-mcp uvx revit-model-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from revit-model-mcp <command>

## When to use it
- read levels, rooms and elements from an open Revit model in Claude Code
- find doors on a floor, highlight them in 3D and override their graphics
- run a model health check before issue and get a list of failures
- move selected elements and roll back the change with one Undo
- control Revit on a Windows workstation from a Mac over SSH

## Example prompts
- Call `revit_ping`, then tell me which model is open
- Find the largest room on the level with the most area and show it on the plan
- Run a model health check with `revit_model_health` and list what failed

## Similar
- [Horizun Revit MCP](https://affpapa.org/en/nevibecode/mcp/horizun-revit-mcp.md) — MCP server · ★ 94 repo stars
- [cad-to-data](https://affpapa.org/en/nevibecode/skills/cad-to-data.md) — skill · 371 installs
- [batch-cad-converter](https://affpapa.org/en/nevibecode/skills/batch-cad-converter.md) — skill · 146 installs
- [RvtMcp](https://affpapa.org/en/nevibecode/mcp/rvtmcp.md) — MCP server · ★ 141 repo stars
- [Autodesk Revit MCP Server](https://affpapa.org/en/nevibecode/mcp/autodesk-revit-mcp-server.md) — MCP server · ★ 125 repo stars
- [revit-bim](https://affpapa.org/en/nevibecode/plugins/revit-bim.md) — plugin · ★ 11 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
