Claude MCP Server¶

The Normal Framework MCP server lets Claude interact directly with your building automation sites — querying points, writing hooks, modeling equipment, and more.

Normal Online Required

Your site must be connected to Normal Online with an active tunnel. The MCP server communicates with the site through the Normal Online tunnel; local-only sites are not supported.

Setup¶

Claude Code¶

Add the following to your project's .mcp.json (or ~/.claude/.mcp.json for global config):

{
  "mcpServers": {
    "nf-online": {
      "type": "url",
      "url": "https://portal.normal-online.net/mcp"
    }
  }
}

Claude Desktop¶

Add the same configuration under Settings → Developer → MCP Servers:

{
  "mcpServers": {
    "nf-online": {
      "type": "url",
      "url": "https://portal.normal-online.net/mcp"
    }
  }
}

Authentication¶

On first use, Claude will open a browser window for you to log in with your Normal Online account. After authenticating you can select a tenant and site to work with.

Verifying the Connection¶

Once configured, ask Claude to:

List my sites

If the tunnel is active, you'll see your site information.

Troubleshooting¶

Connection refused / timeout — The site's tunnel to Normal Online may be down. Check that the site is online in the Normal Online dashboard.

Authentication errors — Try removing and re-adding the MCP server to re-authenticate.

Intermittent failures — Tunnel connections can drop briefly. Claude will automatically retry failed tool calls.