butlr-mcp

[](https://www.npmjs.com/package/@butlr/butlr-mcp-server) [](https://opensource.org/licenses/MIT) [](https://nodejs.org/)

A Model Context Protocol (MCP) server that connects AI assistants to Butlr's occupancy sensing platform. Query real-time space utilization, search facility assets, and analyze occupancy patterns through natural language.

• Find available spaces — "Are there any free conference rooms right now with capacity for 8?"
• Monitor occupancy — "How busy is the cafe? Should I head there now?"
• Analyze trends — "Show me occupancy patterns for Floor 3 over the past week"
• Search your portfolio — "Find all rooms named 'huddle' across Building 2"
• Check sensor health — "Which sensors are offline or need battery replacement?"
• Track foot traffic — "How many people entered the main lobby today?"

• Node.js 18 or higher
• An MCP-compatible client (Claude Desktop, Claude Code, VS Code, Cursor, etc.)
• Butlr API token — see Getting API Credentials

<details open> <summary><strong>Claude Desktop</strong></summary>

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "butlr": {
      "command": "npx",
      "args": ["-y", "@butlr/butlr-mcp-server@latest"],
      "env": {
        "BUTLR_CLIENT_ID": "your_client_id",
        "BUTLR_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}