@bmhall2/skylight-mcp 1.1.7

package/dist/config.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+declare const ConfigSchema: z.ZodEffects<z.ZodObject<{
+    email: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    token: z.ZodOptional<z.ZodString>;
+    authType: z.ZodDefault<z.ZodEnum<["bearer", "basic"]>>;
+    frameId: z.ZodString;
+    timezone: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    authType: "bearer" | "basic";
+    frameId: string;
+    timezone: string;
+    email?: string | undefined;
+    password?: string | undefined;
+    token?: string | undefined;
+}, {
+    frameId: string;
+    email?: string | undefined;
+    password?: string | undefined;
+    token?: string | undefined;
+    authType?: "bearer" | "basic" | undefined;
+    timezone?: string | undefined;
+}>, {
+    authType: "bearer" | "basic";
+    frameId: string;
+    timezone: string;
+    email?: string | undefined;
+    password?: string | undefined;
+    token?: string | undefined;
+}, {
+    frameId: string;
+    email?: string | undefined;
+    password?: string | undefined;
+    token?: string | undefined;
+    authType?: "bearer" | "basic" | undefined;
+    timezone?: string | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export interface ResolvedConfig {
+    token: string;
+    frameId: string;
+    timezone: string;
+    authType: "bearer" | "basic";
+}
+export declare function loadConfig(): Config;
+export declare function getConfig(): Config;
+/**
+ * Check if config uses email/password auth
+ */
+export declare function usesEmailAuth(config: Config): boolean;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0Bf,CAAC;AAEJ,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC9B;AAED,wBAAgB,UAAU,IAAI,MAAM,CA0CnC;AAID,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/config.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+// Config schema supports two auth methods:
+// 1. Email/password (preferred) - will login and get token automatically
+// 2. Token-based (legacy) - for manual token capture
+const ConfigSchema = z
+    .object({
+    // Email/password auth (preferred)
+    email: z.string().email().optional(),
+    password: z.string().min(1).optional(),
+    // Token-based auth (legacy)
+    token: z.string().min(1).optional(),
+    authType: z.enum(["bearer", "basic"]).default("bearer"),
+    // Required
+    frameId: z.string().min(1, "SKYLIGHT_FRAME_ID is required"),
+    // Optional
+    timezone: z.string().default("America/New_York"),
+})
+    .refine((data) => {
+    // Must have either email+password OR token
+    const hasEmailAuth = data.email && data.password;
+    const hasTokenAuth = !!data.token;
+    return hasEmailAuth || hasTokenAuth;
+}, {
+    message: "Either SKYLIGHT_EMAIL and SKYLIGHT_PASSWORD, or SKYLIGHT_TOKEN must be provided",
+});
+export function loadConfig() {
+    const result = ConfigSchema.safeParse({
+        email: process.env.SKYLIGHT_EMAIL,
+        password: process.env.SKYLIGHT_PASSWORD,
+        token: process.env.SKYLIGHT_TOKEN,
+        frameId: process.env.SKYLIGHT_FRAME_ID,
+        authType: process.env.SKYLIGHT_AUTH_TYPE || "bearer",
+        timezone: process.env.SKYLIGHT_TIMEZONE || "America/New_York",
+    });
+    if (!result.success) {
+        const errors = result.error.errors.map((e) => `  - ${e.message}`).join("\n");
+        console.error(`
+Skylight MCP Server - Configuration Error
+
+Missing or invalid configuration:
+${errors}
+
+Authentication (choose one):
+  Option 1 - Email/Password (recommended):
+    SKYLIGHT_EMAIL    - Your Skylight account email
+    SKYLIGHT_PASSWORD - Your Skylight account password
+
+  Option 2 - Manual Token:
+    SKYLIGHT_TOKEN    - Your Skylight API token
+    SKYLIGHT_AUTH_TYPE - 'bearer' or 'basic' (default: bearer)
+
+Required:
+  SKYLIGHT_FRAME_ID - Your frame/household ID
+
+Optional:
+  SKYLIGHT_TIMEZONE - Timezone for dates (default: America/New_York)
+
+To find your frame ID:
+1. Log in to the Skylight app
+2. Use a proxy tool to capture API traffic
+3. Look for the frame ID in URLs like /api/frames/{frameId}/chores
+`);
+        process.exit(1);
+    }
+    return result.data;
+}
+let cachedConfig = null;
+export function getConfig() {
+    if (!cachedConfig) {
+        cachedConfig = loadConfig();
+    }
+    return cachedConfig;
+}
+/**
+ * Check if config uses email/password auth
+ */
+export function usesEmailAuth(config) {
+    return !!(config.email && config.password);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2CAA2C;AAC3C,yEAAyE;AACzE,qDAAqD;AACrD,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,kCAAkC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAEtC,4BAA4B;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAEvD,WAAW;IACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IAE3D,WAAW;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;CACjD,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,2CAA2C;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC;IACjD,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAClC,OAAO,YAAY,IAAI,YAAY,CAAC;AACtC,CAAC,EACD;IACE,OAAO,EAAE,iFAAiF;CAC3F,CACF,CAAC;AAWJ,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;QACpC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACjC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACvC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACjC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACtC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,QAAQ;QACpD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,kBAAkB;KAC9D,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO,CAAC,KAAK,CAAC;;;;EAIhB,MAAM;;;;;;;;;;;;;;;;;;;;;CAqBP,CAAC,CAAC;QACC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { createServer } from "./server.js";
+async function main() {
+    const server = await createServer();
+    await server.start();
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IACpC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): Promise<{
+    start: () => Promise<void>;
+}>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC,CAmCD"}

package/dist/server.js

@@ -0,0 +1,48 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { initializeClient } from "./api/client.js";
+import { registerCalendarTools } from "./tools/calendar.js";
+import { registerChoreTools } from "./tools/chores.js";
+import { registerListTools } from "./tools/lists.js";
+import { registerTaskTools } from "./tools/tasks.js";
+import { registerFamilyTools } from "./tools/family.js";
+import { registerRewardTools } from "./tools/rewards.js";
+import { registerMiscTools } from "./tools/misc.js";
+import { registerMealTools } from "./tools/meals.js";
+import { registerPhotoTools } from "./tools/photos.js";
+/**
+ * Create and configure the MCP server
+ */
+export async function createServer() {
+    // Validate configuration before starting
+    loadConfig();
+    // Initialize client and get subscription status BEFORE tool registration
+    const client = await initializeClient();
+    const hasPlus = client.hasPlus();
+    const server = new McpServer({
+        name: "skylight",
+        version: "1.0.0",
+    });
+    // Register base tools (always available)
+    registerCalendarTools(server);
+    registerChoreTools(server);
+    registerListTools(server);
+    registerTaskTools(server);
+    registerFamilyTools(server);
+    registerMiscTools(server);
+    // Register Plus-only tools (hidden for non-Plus users)
+    if (hasPlus) {
+        registerRewardTools(server);
+        registerMealTools(server);
+        registerPhotoTools(server);
+    }
+    return {
+        start: async () => {
+            const transport = new StdioServerTransport();
+            await server.connect(transport);
+            console.error(`Skylight MCP Server started (Plus: ${hasPlus})`);
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAGhC,yCAAyC;IACzC,UAAU,EAAE,CAAC;IAEb,yEAAyE;IACzE,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,yCAAyC;IACzC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,uDAAuD;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,OAAO,GAAG,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/calendar.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCalendarTools(server: McpServer): void;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/tools/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/tools/calendar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwU7D"}

package/dist/tools/calendar.js

@@ -0,0 +1,297 @@
+import { z } from "zod";
+import { getCalendarEvents, getSourceCalendars, createCalendarEvent, updateCalendarEvent, deleteCalendarEvent, } from "../api/endpoints/calendar.js";
+import { getTodayDate, parseDate, formatDateForDisplay } from "../utils/dates.js";
+import { formatErrorForMcp } from "../utils/errors.js";
+import { getConfig } from "../config.js";
+export function registerCalendarTools(server) {
+    // get_calendar_events tool
+    server.tool("get_calendar_events", `Get calendar events from Skylight.
+
+Use this to answer questions like:
+- "What's on my calendar today?"
+- "What do we have scheduled this weekend?"
+- "Are there any events on Friday?"
+
+Returns a list of events with their titles, times, and details.`, {
+        date: z
+            .string()
+            .optional()
+            .describe("Start date (YYYY-MM-DD or 'today', 'tomorrow', day name). Defaults to today."),
+        dateEnd: z
+            .string()
+            .optional()
+            .describe("End date (YYYY-MM-DD). Defaults to same as start date."),
+    }, async ({ date, dateEnd }) => {
+        try {
+            const config = getConfig();
+            const startDate = date ? parseDate(date, config.timezone) : getTodayDate(config.timezone);
+            const endDate = dateEnd ? parseDate(dateEnd, config.timezone) : startDate;
+            const { events, categories } = await getCalendarEvents({
+                dateMin: startDate,
+                dateMax: endDate,
+                timezone: config.timezone,
+            });
+            if (events.length === 0) {
+                const dateRange = startDate === endDate
+                    ? formatDateForDisplay(startDate)
+                    : `${formatDateForDisplay(startDate)} to ${formatDateForDisplay(endDate)}`;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No calendar events found for ${dateRange}.`,
+                        },
+                    ],
+                };
+            }
+            // Build category lookup for assignee names
+            const categoryMap = new Map(categories.map((c) => [c.id, c.attributes.label ?? "Unknown"]));
+            // Format events for display
+            const eventList = events
+                .map((event) => {
+                const attrs = event.attributes;
+                const parts = [];
+                // Add all available attributes
+                for (const [key, value] of Object.entries(attrs)) {
+                    if (value !== null && value !== undefined) {
+                        parts.push(`  ${key}: ${value}`);
+                    }
+                }
+                // Resolve category assignments from relationships
+                const categoryIds = event.relationships?.categories?.data ?? [];
+                if (categoryIds.length > 0) {
+                    const names = categoryIds
+                        .map((ref) => categoryMap.get(ref.id) ?? ref.id)
+                        .join(", ");
+                    parts.push(`  assigned_to: ${names}`);
+                }
+                return `- Event (ID: ${event.id})\n${parts.join("\n")}`;
+            })
+                .join("\n\n");
+            const dateRange = startDate === endDate
+                ? formatDateForDisplay(startDate)
+                : `${formatDateForDisplay(startDate)} to ${formatDateForDisplay(endDate)}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Calendar events for ${dateRange}:\n\n${eventList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatErrorForMcp(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // get_source_calendars tool
+    server.tool("get_source_calendars", `Get connected calendar sources synced to Skylight.
+
+Use this to answer:
+- "Which calendars are synced to Skylight?"
+- "What calendar accounts are connected?"
+
+Returns a list of connected calendar sources (Google, iCloud, etc.).`, {}, async () => {
+        try {
+            const calendars = await getSourceCalendars();
+            if (calendars.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No calendar sources are connected to Skylight.",
+                        },
+                    ],
+                };
+            }
+            const calendarList = calendars
+                .map((cal) => {
+                const attrs = cal.attributes;
+                const parts = [`- Calendar (ID: ${cal.id})`];
+                for (const [key, value] of Object.entries(attrs)) {
+                    if (value !== null && value !== undefined) {
+                        parts.push(`  ${key}: ${value}`);
+                    }
+                }
+                return parts.join("\n");
+            })
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Connected calendar sources:\n\n${calendarList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatErrorForMcp(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // create_calendar_event tool
+    server.tool("create_calendar_event", `Create a new calendar event in Skylight.
+
+Use this when:
+- Scheduling a new event: "Add a dentist appointment on Friday at 2pm"
+- Creating family activities: "Schedule soccer practice every Saturday at 10am"
+- Adding reminders: "Put Mom's birthday on the calendar"
+
+Parameters:
+- summary (required): Event title (e.g., "Dentist Appointment")
+- startsAt (required): Start time in ISO format or natural language
+- endsAt (required): End time in ISO format or natural language
+- allDay: Set to true for all-day events
+- description: Additional notes for the event
+- location: Where the event takes place
+- categoryIds: Family member IDs to associate with the event
+
+Returns: The created event details.
+
+Related: Use get_family_members to get category IDs for assignments.`, {
+        summary: z.string().describe("Event title (e.g., 'Dentist Appointment')"),
+        startsAt: z.string().describe("Start time (ISO format like '2025-01-15T14:00:00')"),
+        endsAt: z.string().describe("End time (ISO format like '2025-01-15T15:00:00')"),
+        allDay: z.boolean().optional().default(false).describe("True for all-day events"),
+        description: z.string().optional().describe("Additional notes for the event"),
+        location: z.string().optional().describe("Event location"),
+        categoryIds: z.array(z.string()).optional().describe("Family member IDs to assign"),
+    }, async ({ summary, startsAt, endsAt, allDay, description, location, categoryIds }) => {
+        try {
+            const config = getConfig();
+            const event = await createCalendarEvent({
+                summary,
+                starts_at: startsAt,
+                ends_at: endsAt,
+                all_day: allDay,
+                description,
+                location,
+                category_ids: categoryIds,
+                timezone: config.timezone,
+                kind: "standard",
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created calendar event "${summary}" (ID: ${event.id})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // update_calendar_event tool
+    server.tool("update_calendar_event", `Update an existing calendar event.
+
+Use this when:
+- Changing event time: "Move the dentist appointment to 3pm"
+- Updating event details: "Add location to the meeting"
+- Renaming an event: "Change 'Doctor' to 'Dr. Smith checkup'"
+
+Parameters:
+- eventId (required): ID of the event to update (from get_calendar_events)
+- summary: New title for the event
+- startsAt: New start time (ISO format)
+- endsAt: New end time (ISO format)
+- description: Updated notes
+- location: Updated location
+- categoryIds: Updated family member assignments
+
+Returns: The updated event details.`, {
+        eventId: z.string().describe("ID of the event to update"),
+        summary: z.string().optional().describe("New event title"),
+        startsAt: z.string().optional().describe("New start time (ISO format)"),
+        endsAt: z.string().optional().describe("New end time (ISO format)"),
+        allDay: z.boolean().optional().describe("Change to all-day event"),
+        description: z.string().optional().describe("Updated notes"),
+        location: z.string().optional().describe("Updated location"),
+        categoryIds: z.array(z.string()).optional().describe("Updated family member assignments"),
+    }, async ({ eventId, summary, startsAt, endsAt, allDay, description, location, categoryIds }) => {
+        try {
+            const updates = {};
+            if (summary !== undefined)
+                updates.summary = summary;
+            if (startsAt !== undefined)
+                updates.starts_at = startsAt;
+            if (endsAt !== undefined)
+                updates.ends_at = endsAt;
+            if (allDay !== undefined)
+                updates.all_day = allDay;
+            if (description !== undefined)
+                updates.description = description;
+            if (location !== undefined)
+                updates.location = location;
+            if (categoryIds !== undefined)
+                updates.category_ids = categoryIds;
+            const event = await updateCalendarEvent(eventId, updates);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Updated calendar event (ID: ${event.id})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // delete_calendar_event tool
+    server.tool("delete_calendar_event", `Delete a calendar event from Skylight.
+
+Use this when:
+- Canceling an event: "Remove the dentist appointment"
+- Deleting old events: "Delete the meeting from yesterday"
+
+Parameters:
+- eventId (required): ID of the event to delete (from get_calendar_events)
+
+Note: This permanently removes the event. For recurring events, this may only delete one instance.`, {
+        eventId: z.string().describe("ID of the event to delete"),
+    }, async ({ eventId }) => {
+        try {
+            await deleteCalendarEvent(eventId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Deleted calendar event (ID: ${eventId})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=calendar.js.map

package/dist/tools/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/tools/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,2BAA2B;IAC3B,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB;;;;;;;gEAO4D,EAC5D;QACE,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8EAA8E,CAAC;QAC3F,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;KACtE,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1F,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE1E,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,CAAC;gBACrD,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,OAAO;gBAChB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,SAAS,GACb,SAAS,KAAK,OAAO;oBACnB,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC;oBACjC,CAAC,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,gCAAgC,SAAS,GAAG;yBACnD;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,2CAA2C;YAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAC/D,CAAC;YAEF,4BAA4B;YAC5B,MAAM,SAAS,GAAG,MAAM;iBACrB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACb,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC;gBAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;gBAE3B,+BAA+B;gBAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;gBAED,kDAAkD;gBAClD,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC;gBAChE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,KAAK,GAAG,WAAW;yBACtB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;yBAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;oBACd,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;gBACxC,CAAC;gBAED,OAAO,gBAAgB,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,CAAC,CAAC;iBACD,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,MAAM,SAAS,GACb,SAAS,KAAK,OAAO;gBACnB,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC;gBACjC,CAAC,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YAE/E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uBAAuB,SAAS,QAAQ,SAAS,EAAE;qBAC1D;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;qBAC/B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,4BAA4B;IAC5B,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB;;;;;;qEAMiE,EACjE,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAE7C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,gDAAgD;yBACvD;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAG,SAAS;iBAC3B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACX,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC;gBAC7B,MAAM,KAAK,GAAa,CAAC,mBAAmB,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;gBAEvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;gBAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC;iBACD,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kCAAkC,YAAY,EAAE;qBACvD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;qBAC/B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB;;;;;;;;;;;;;;;;;;qEAkBiE,EACjE;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACzE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QACnF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC/E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC7E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC1D,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KACpF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;QAClF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC;gBACtC,OAAO;gBACP,SAAS,EAAE,QAAQ;gBACnB,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,MAAM;gBACf,WAAW;gBACX,QAAQ;gBACR,YAAY,EAAE,WAAW;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,UAAU;aACjB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,OAAO,UAAU,KAAK,CAAC,EAAE,GAAG;qBAC9D;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB;;;;;;;;;;;;;;;;oCAgBgC,EAChC;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACvE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACnE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC5D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC5D,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KAC1F,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;QAC3F,IAAI,CAAC;YACH,MAAM,OAAO,GAA4B,EAAE,CAAC;YAC5C,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;YACrD,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC;YACzD,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC;YACnD,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC;YACnD,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;YACjE,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACxD,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO,CAAC,YAAY,GAAG,WAAW,CAAC;YAElE,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE1D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+BAA+B,KAAK,CAAC,EAAE,GAAG;qBACjD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB;;;;;;;;;mGAS+F,EAC/F;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC1D,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+BAA+B,OAAO,GAAG;qBAChD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/chores.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerChoreTools(server: McpServer): void;
+//# sourceMappingURL=chores.d.ts.map

package/dist/tools/chores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chores.d.ts","sourceRoot":"","sources":["../../src/tools/chores.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoX1D"}