Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

2.0 KB
Raw Blame

AEC Model Bridge: install notes for AI agents (Cline)

UNVERIFIED: written for Cline's MCP marketplace flow and not yet tested with Cline.

AEC Model Bridge is an MCP server for Autodesk Revit. It needs Windows. For live work it also needs a licensed Revit 2024 to 2027 and the AEC Model Bridge add-in. Without Revit it runs in mock mode on sample data.

Do these steps in order. Stop and tell the person if a step fails. Do not guess.

  1. Check that uv is installed: run uv --version. If it is missing, ask the person to install it from https://docs.astral.sh/uv/ and wait.
  2. Ask the person which mode they want.
  3. Add this to the MCP settings file (cline_mcp_settings.json), keeping any servers already there:
{
  "mcpServers": {
    "aec-model-bridge": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Sam-AEC/aec-model-bridge#subdirectory=packages/mcp-server-revit",
        "aec-model-bridge"
      ],
      "env": { "MCP_REVIT_MODE": "bridge" }
    }
  }
}
  1. Do not set MCP_REVIT_APPROVAL_MODE. The default, ask_first (older name required), blocks every model change until a person approves a plan. look_only blocks them entirely. Never turn it off.
  2. Ask the person to restart the server in Cline, then list the tools to check it started.

Using the tools safely: read first, draft a plan for any change, then stop and ask the person to approve the plan themselves in the AEC Bridge panel in Revit. Never approve a plan yourself. Do not say a change was made until the result confirms it. More: https://github.com/Sam-AEC/aec-model-bridge/blob/main/plugin/skills/revit-review/SKILL.md

Privacy: https://github.com/Sam-AEC/aec-model-bridge/blob/main/docs/privacy.md