Installing the MCP Server for Revit - Python

• Revit with pyRevit installed
pyRevit and the MCP Server for Revit - Python
• uv, the Python package manager the project uses. To install it, open PowerShell and run:

powershell

Copy

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Git, which you need for the clone step below

In Revit, go to the pyRevit tab → Settings → Routes and turn on Routes Server. pyRevit then listens at http://localhost:48884/.

cd C:\Toolsgit clone https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python

Then rename the folder so it ends in .extension, for example mcp-server-for-revit-python.extension.

Go to pyRevit tab → Settings → Custom Extensions and add the folder that contains your .extension folder (in this example, C:\Tools). Save, then reload pyRevit. You may need to restart Revit completely.

pyRevit’s Extensions manager also has an install option. However, the clone gives you the main.py file the MCP server needs anyway, so using that single copy for both is simpler.

uv run --frozen python -c "import anyio; from main import revit_get; print(anyio.run(revit_get, '/status/'))"

You should get back "status": "active" and "health": "healthy". Opening the URL in a browser won’t work for this test, because the browser request isn’t paired and gets denied.

Claude Desktop: go to Settings → Developer → Edit Config and add the following inside mcpServers:

json

"Revit Connector": {  "command": "uv",  "args": ["run", "--frozen", "mcp", "run",           "C:\\Tools\\mcp-server-for-revit-python.extension\\main.py"]}

Restart Claude Desktop. The Revit tools should then appear.

Claude Code:

powershell

claude mcp add -s user "Revit-Connector" -- uv run --frozen mcp run C:\Tools\mcp-server-for-revit-python.extension\main.py

• Use the default stdio setup above rather than the HTTP modes. stdio needs no token in your config.
• If Claude Desktop can’t find uv, replace "uv" with its full path. Running where uv in PowerShell will show it.
• Any request that edits the model or runs Python shows you the payload in Revit first, so keep an eye out for that prompt.
• To revoke access, choose MCP → Bridge → Disconnect.