home / mcp / buildinglink mcp server

BuildingLink MCP Server

MCP server for BuildingLink

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "johnagan-buildinglink-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "johnagan/buildinglink-mcp"
      ],
      "env": {
        "BUILDINGLINK_PASSWORD": "your-password",
        "BUILDINGLINK_USERNAME": "your-username"
      }
    }
  }
}

This MCP server lets you connect your LLMs to BuildingLink data, giving you direct access to occupant profiles, buildings, deliveries, announcements, events, and more from BuildingLink. It streamlines how you query BuildingLink data in your AI workflows and applications.

How to use

To use this MCP server, configure it in your host’s MCP setup and then run your MCP client against the server. You can call each available tool to fetch specific BuildingLink data and feed it into your prompts or downstream processes. The tools cover common data points such as the logged-in occupant profile, preferred vendors, the current user token, associated buildings, user profile, deliveries, library items, announcements, and events.

Practical usage patterns include: retrieving your buildings to scope data, pulling deliveries to monitor inbound items, and listing announcements to stay informed. You can combine multiple tools in a single workflow to assemble a comprehensive BuildingLink data snapshot for your LLM to reason over.

How to install

Prerequisites: ensure you have a supported runtime installed. This server uses Node.js and npm for package execution.

Step 1. Create your MCP host configuration with the BuildingLink MCP settings. You will provide your BuildingLink username and password to authorize access.

{
  "mcpServers": {
    "buildinglink": {
      "command": "npx",
      "args": ["-y", "johnagan/buildinglink-mcp"],
      "env": {
        "BUILDINGLINK_USERNAME": "your-username",
        "BUILDINGLINK_PASSWORD": "your-password"
      }
    }
  }
}

Additional notes

The BuildingLink MCP server provides the following tools to access data: getOccupant, getVendors, getToken, getBuildings, getUser, getDeliveries, getLibrary, getAnnouncements, getEvents. Each tool is available through your MCP client after the server is running and your host configuration is loaded.

Tools and access

The following endpoints are exposed by the BuildingLink MCP server for you to call from your MCP client.

Available tools

getOccupant

Fetch the logged-in occupant's profile information.

getVendors

Retrieve a list of preferred vendors.

getToken

Obtain the authentication token for the current session.

getBuildings

List buildings (properties) associated with the logged-in user.

getUser

Get the logged-in BuildingLink user profile.

getDeliveries

List all deliveries for the logged-in user.

getLibrary

List all library items for the user and their building.

getAnnouncements

List all announcements for the user and their building.

getEvents

List all events for the user and their building.