Connect Seam to Claude

mkdir seam-mcp
cd seam-mcp
npm init -y
npm install @modelcontextprotocol/sdk zod seam

{
  "name": "seam-mcp",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "zod": "^3.22.0",
    "seam": "^1.0.0"
  }
}

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { Seam } from "seam";
import { z } from "zod";

const SEAM_API_KEY = process.env.SEAM_API_KEY;
if (!SEAM_API_KEY) {
  console.error("Missing SEAM_API_KEY environment variable");
  process.exit(1);
}

const seam = new Seam({ apiKey: SEAM_API_KEY });

const server = new McpServer({
  name: "seam",
  version: "1.0.0",
});

// Tool 1: List all devices (locks, sensors, thermostats)
server.tool(
  "list-devices",
  "List every device in the Seam workspace: locks, noise sensors, and thermostats. Returns device_id, display_name, device_type, manufacturer, and online status. Use this as the entry point for any question about devices.",
  {},
  async () => {
    const devices = await seam.devices.list();
    return {
      content: [{ type: "text", text: JSON.stringify(devices, null, 2) }],
    };
  }
);

// Tool 2: List locks with online/battery status
server.tool(
  "list-locks",
  "List only smart locks in the Seam workspace. Returns lock state (locked/unlocked), battery level, and online status for each.",
  {},
  async () => {
    const locks = await seam.locks.list();
    return {
      content: [{ type: "text", text: JSON.stringify(locks, null, 2) }],
    };
  }
);

// Tool 3: List access codes on a specific lock
server.tool(
  "list-access-codes",
  "List all access codes for a specific lock. Returns code, name, starts_at, ends_at, and status (set/unset) for each code.",
  {
    device_id: z
      .string()
      .describe("The Seam device_id of the lock to query. Get this from list-locks."),
  },
  async ({ device_id }) => {
    const codes = await seam.accessCodes.list({ device_id });
    return {
      content: [{ type: "text", text: JSON.stringify(codes, null, 2) }],
    };
  }
);

// Tool 4: Create a time-bounded access code
server.tool(
  "create-access-code",
  "Create a new time-bounded access code on a lock. Use this for guest check-ins, cleaner access, and maintenance visits. The code will be active from starts_at to ends_at.",
  {
    device_id: z
      .string()
      .describe("The Seam device_id of the lock. Get this from list-locks."),
    name: z
      .string()
      .describe("Human-readable name for the code (e.g. 'Smith stay — Mar 14-17')"),
    code: z
      .string()
      .optional()
      .describe(
        "Optional 4-8 digit PIN code. If omitted, Seam will generate one."
      ),
    starts_at: z
      .string()
      .describe("ISO 8601 UTC timestamp when the code becomes active (e.g. 2026-04-14T15:00:00Z)"),
    ends_at: z
      .string()
      .describe("ISO 8601 UTC timestamp when the code expires (e.g. 2026-04-17T11:00:00Z)"),
  },
  async ({ device_id, name, code, starts_at, ends_at }) => {
    const result = await seam.accessCodes.create({
      device_id,
      name,
      code,
      starts_at,
      ends_at,
    });
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }
);

// Tool 5: List noise sensors
server.tool(
  "list-noise-sensors",
  "List noise sensors (Minut, NoiseAware) in the Seam workspace. Returns current readings and threshold status for each sensor.",
  {},
  async () => {
    const sensors = await seam.noiseSensors.list();
    return {
      content: [{ type: "text", text: JSON.stringify(sensors, null, 2) }],
    };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "seam": {
      "command": "node",
      "args": ["/absolute/path/to/seam-mcp/index.js"],
      "env": {
        "SEAM_API_KEY": "seam_your_api_key_here"
      }
    }
  }
}