Model MCP — Claude Code MCP server: connect Revit to AI
Connects Autodesk Revit to Claude Code, Codex, Cursor and other MCP clients. Reads the open model, checks it and changes it through prompts.
MIT ★ 20 updated 2026-10-24
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-mcpWhat Model MCP 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.
What it helps with
- 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 for the agent
- 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_healthand list what failed
How to install Model MCP
Platform CLI
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-mcpReplace <…> 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>
Platform CLI
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-mcpReplace <…> 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>
Config file
{
"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>
Config file
{
"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>
Platform CLI
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-mcpReplace <…> 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>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Model MCP
How to install Model MCP in Claude Code?
First install the MSI add-in on the machine with Revit, then in Claude Code run claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -e REVIT_MCP_REDACT_PATHS=1 -- uvx revit-model-mcp.
What does Model MCP do?
Connects Revit to Claude Code and other MCP clients. The agent reads the model, checks it, changes elements and graphics — everything rolls back through Revit Undo.
Does Model MCP require Python?
The MSI package includes a bundled server, no Python needed. For the PyPI version (uvx revit-model-mcp), install uv.