@davidwoods/skylight-mcp 0.0.0-stage → 1.8.0

package/dist/tools/calendar.js

@@ -0,0 +1,334 @@
+import { z } from "zod";
+import { getCalendarEvents, getSourceCalendars, createCalendarEvent, updateCalendarEvent, deleteCalendarEvent, withFrameOffset, } from "../api/endpoints/calendar.js";
+import { getTodayDate, parseDate, formatDateForDisplay } from "../utils/dates.js";
+import { formatErrorForMcp } from "../utils/errors.js";
+import { getConfig } from "../config.js";
+import { getCategories, resolveProfileIds } from "../api/endpoints/categories.js";
+// Fields the event listing carries that identify people or accounts and tell a model nothing it
+// can act on. Everything else is still printed, so new Skylight fields show up without a code change.
+const HIDDEN_EVENT_FIELDS = new Set([
+    "owner_email",
+    "calendar_id",
+    "calendar_account_id",
+    "invited_emails",
+    "uid",
+    "supports_notification_settings",
+]);
+/** Profile names an event is assigned to, or [] when none or not determinable. */
+export function eventProfileNames(event, labelById) {
+    const ids = new Set();
+    for (const ref of event.relationships?.categories?.data ?? [])
+        if (ref?.id)
+            ids.add(String(ref.id));
+    const single = event.relationships?.category?.data?.id;
+    if (single)
+        ids.add(String(single));
+    const fromAttrs = event.attributes.category_ids;
+    if (Array.isArray(fromAttrs))
+        for (const id of fromAttrs)
+            ids.add(String(id));
+    return [...ids].map((id) => labelById.get(id)).filter((n) => Boolean(n));
+}
+/** One event as text: no emails, calendar ids or UIDs, and the assigned profiles when known. */
+export function formatEventForTool(event, labelById) {
+    const parts = [];
+    const who = eventProfileNames(event, labelById);
+    if (who.length)
+        parts.push(`  profiles: ${who.join(", ")}`);
+    for (const [key, value] of Object.entries(event.attributes)) {
+        if (HIDDEN_EVENT_FIELDS.has(key))
+            continue;
+        if (value !== null && value !== undefined)
+            parts.push(`  ${key}: ${value}`);
+    }
+    return `- Event (ID: ${event.id})\n${parts.join("\n")}`;
+}
+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 = 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}.`,
+                        },
+                    ],
+                };
+            }
+            // Profile names are a best-effort extra: a failed lookup must not hide the events.
+            const labelById = new Map();
+            try {
+                for (const c of await getCategories())
+                    if (c.attributes.label)
+                        labelById.set(String(c.id), c.attributes.label);
+            }
+            catch {
+                /* leave empty */
+            }
+            const eventList = events.map((event) => formatEventForTool(event, labelById)).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
+- profiles: Profile names to assign (e.g. ["Alex"]); categoryIds is the ID fallback
+
+Returns: The created event details.
+
+Related: get_family_members lists the profile names and IDs.`, {
+        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"),
+        profiles: z.array(z.string()).optional().describe("Profile names to assign, e.g. [\"Alex\", \"Jordan\"] (see get_family_members)."),
+        categoryIds: z.array(z.string()).optional().describe("Profile IDs to assign. Prefer profiles."),
+    }, async ({ summary, startsAt, endsAt, allDay, description, location, profiles, categoryIds }) => {
+        try {
+            const config = getConfig();
+            if (profiles?.length && categoryIds?.length)
+                throw new Error("Give profiles or categoryIds, not both.");
+            const resolved = profiles?.length ? (await resolveProfileIds(profiles)).ids : categoryIds;
+            const event = await createCalendarEvent({
+                summary,
+                starts_at: withFrameOffset(startsAt, config.timezone),
+                ends_at: withFrameOffset(endsAt, config.timezone),
+                all_day: allDay,
+                description,
+                location,
+                category_ids: resolved,
+                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"),
+        profiles: z.array(z.string()).optional().describe("Profile names to assign instead of the current ones, e.g. [\"Alex\"]."),
+        categoryIds: z.array(z.string()).optional().describe("Profile IDs to assign. Prefer profiles."),
+    }, async ({ eventId, summary, startsAt, endsAt, allDay, description, location, profiles, categoryIds }) => {
+        try {
+            if (profiles?.length && categoryIds?.length)
+                throw new Error("Give profiles or categoryIds, not both.");
+            const updates = {};
+            if (summary !== undefined)
+                updates.summary = summary;
+            const tz = getConfig().timezone;
+            if (startsAt !== undefined)
+                updates.starts_at = withFrameOffset(startsAt, tz);
+            if (endsAt !== undefined)
+                updates.ends_at = withFrameOffset(endsAt, tz);
+            if (allDay !== undefined)
+                updates.all_day = allDay;
+            if (description !== undefined)
+                updates.description = description;
+            if (location !== undefined)
+                updates.location = location;
+            if (profiles?.length)
+                updates.category_ids = (await resolveProfileIds(profiles)).ids;
+            else 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":"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"}

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,CAwV1D"}

package/dist/tools/chores.js

@@ -0,0 +1,321 @@
+import { z } from "zod";
+import { getChores, createChore, updateChore, deleteChore, isChoreDone } from "../api/endpoints/chores.js";
+import { resolveProfile } from "../api/endpoints/categories.js";
+import { getTodayDate, getDateOffset, parseDate, parseTime, formatDateForDisplay } from "../utils/dates.js";
+import { formatErrorForMcp } from "../utils/errors.js";
+import { getConfig } from "../config.js";
+export function registerChoreTools(server) {
+    // get_chores tool
+    server.tool("get_chores", `Get chores from Skylight.
+
+Use this to answer:
+- "What chores do I need to do today?"
+- "Show me this week's chores"
+- "What's on the chore chart?"
+- "What chores does [name] have?"
+
+Returns chores with their assignees, due dates, and completion status.`, {
+        date: z
+            .string()
+            .optional()
+            .describe("Start date (YYYY-MM-DD or 'today'). Defaults to today."),
+        dateEnd: z
+            .string()
+            .optional()
+            .describe("End date (YYYY-MM-DD). Defaults to 7 days from start."),
+        includeLate: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Include overdue chores from past dates"),
+        assignee: z
+            .string()
+            .optional()
+            .describe("Filter by family member name (e.g., 'Casey', 'Mom')"),
+        status: z
+            .enum(["pending", "completed", "all"])
+            .optional()
+            .default("pending")
+            .describe("Filter by completion status"),
+    }, async ({ date, dateEnd, includeLate, assignee, status }) => {
+        try {
+            const config = getConfig();
+            const startDate = date ? parseDate(date, config.timezone) : getTodayDate(config.timezone);
+            const endDate = dateEnd ? parseDate(dateEnd, config.timezone) : getDateOffset(7, config.timezone);
+            const result = await getChores({
+                after: startDate,
+                before: endDate,
+                includeLate: includeLate ?? true,
+                includeUpForGrabs: true,
+            });
+            let chores = result.chores;
+            // Filter by status
+            if (status !== "all") {
+                const wantDone = status === "completed";
+                chores = chores.filter((chore) => isChoreDone(chore.attributes.status) === wantDone);
+            }
+            // Build category lookup for assignee names
+            const categoryMap = new Map(result.categories.map((c) => [c.id, c.attributes.label ?? "Unknown"]));
+            // Filter by assignee if specified: exact profile name, so "Ben" never matches "Benjamin"
+            if (assignee) {
+                const wanted = (await resolveProfile(assignee)).id;
+                chores = chores.filter((chore) => chore.relationships?.category?.data?.id === wanted);
+            }
+            if (chores.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No ${status === "all" ? "" : status + " "}chores found${assignee ? ` for ${assignee}` : ""}.`,
+                        },
+                    ],
+                };
+            }
+            // Format chores for display
+            const choreList = chores
+                .map((chore) => {
+                const attrs = chore.attributes;
+                const categoryId = chore.relationships?.category?.data?.id;
+                const assigneeName = categoryId ? categoryMap.get(categoryId) : null;
+                const parts = [
+                    `- ${attrs.summary}`,
+                    `  Date: ${formatDateForDisplay(attrs.start)}${attrs.start_time ? ` at ${attrs.start_time}` : ""}`,
+                    `  Status: ${attrs.status}`,
+                ];
+                if (assigneeName) {
+                    parts.push(`  Assigned to: ${assigneeName}`);
+                }
+                else if (attrs.up_for_grabs) {
+                    parts.push(`  Assigned to: nobody (up for grabs)`);
+                }
+                if (attrs.recurring) {
+                    parts.push(`  Recurring: Yes${attrs.recurrence_set ? ` (${attrs.recurrence_set})` : ""}`);
+                }
+                if (attrs.reward_points) {
+                    parts.push(`  Reward points: ${attrs.reward_points}`);
+                }
+                return parts.join("\n");
+            })
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Chores:\n\n${choreList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatErrorForMcp(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // create_chore tool
+    server.tool("create_chore", `Add a new chore to Skylight.
+
+Use this when the user wants to:
+- Add a new task like "empty the dishwasher"
+- Assign chores to family members
+- Create recurring chores
+
+The chore will appear on the Skylight display.`, {
+        summary: z.string().describe("Chore description (e.g., 'Empty the dishwasher')"),
+        date: z
+            .string()
+            .optional()
+            .describe("Due date (YYYY-MM-DD or 'today', 'tomorrow', day name). Defaults to today."),
+        time: z
+            .string()
+            .optional()
+            .describe("Due time (e.g., '10:00 AM', '14:30'). Optional."),
+        assignee: z
+            .string()
+            .optional()
+            .describe("Family member to assign (e.g., 'Casey', 'Mom', 'Kids')"),
+        recurring: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Is this a recurring chore?"),
+        recurrencePattern: z
+            .string()
+            .optional()
+            .describe("For recurring: 'daily', 'weekly', 'weekdays', or RRULE string"),
+        rewardPoints: z
+            .number()
+            .optional()
+            .describe("Reward points for completing this chore"),
+    }, async ({ summary, date, time, assignee, recurring, recurrencePattern, rewardPoints }) => {
+        try {
+            const config = getConfig();
+            const choreDate = date ? parseDate(date, config.timezone) : getTodayDate(config.timezone);
+            // Resolve assignee to category ID
+            let categoryId;
+            if (assignee)
+                categoryId = (await resolveProfile(assignee)).id;
+            // Convert simple recurrence patterns to RRULE
+            let recurrenceSet;
+            if (recurring && recurrencePattern) {
+                const pattern = recurrencePattern.toLowerCase();
+                if (pattern === "daily") {
+                    recurrenceSet = "RRULE:FREQ=DAILY";
+                }
+                else if (pattern === "weekly") {
+                    recurrenceSet = "RRULE:FREQ=WEEKLY";
+                }
+                else if (pattern === "weekdays") {
+                    recurrenceSet = "RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR";
+                }
+                else if (pattern.startsWith("RRULE:")) {
+                    recurrenceSet = pattern;
+                }
+                else {
+                    recurrenceSet = recurrencePattern;
+                }
+            }
+            const chore = await createChore({
+                summary,
+                start: choreDate,
+                startTime: time ? parseTime(time) : undefined,
+                categoryId,
+                recurring: recurring ?? false,
+                recurrenceSet,
+                rewardPoints,
+            });
+            const parts = [
+                `Created chore: "${chore.attributes.summary}"`,
+                `Date: ${formatDateForDisplay(chore.attributes.start)}${chore.attributes.start_time ? ` at ${chore.attributes.start_time}` : ""}`,
+            ];
+            if (assignee) {
+                parts.push(`Assigned to: ${assignee}`);
+            }
+            if (chore.attributes.recurring) {
+                parts.push(`Recurring: Yes`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: parts.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatErrorForMcp(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // update_chore tool
+    server.tool("update_chore", `Update an existing chore in Skylight.
+
+Use this when:
+- Marking a chore as complete: "Mark 'dishes' as done"
+- Changing chore assignment: "Reassign the trash to Casey"
+- Updating chore details: "Change the time for the homework chore"
+
+Parameters:
+- choreId (required): ID of the chore (from get_chores)
+- summary: New description for the chore
+- status: "completed" to mark done, "pending" to mark incomplete
+- date: New due date
+- time: New due time
+- assignee: New family member assignment
+
+Returns: The updated chore details.`, {
+        choreId: z.string().describe("ID of the chore to update"),
+        summary: z.string().optional().describe("New chore description"),
+        status: z.enum(["pending", "completed"]).optional().describe("'completed' to mark done, 'pending' to mark incomplete"),
+        date: z.string().optional().describe("New due date (YYYY-MM-DD or 'today', 'tomorrow')"),
+        time: z.string().nullable().optional().describe("New due time (e.g., '10:00 AM', or null to clear)"),
+        assignee: z.string().nullable().optional().describe("New family member assignment (or null to unassign)"),
+        rewardPoints: z.number().nullable().optional().describe("New reward points (or null to clear)"),
+    }, async ({ choreId, summary, status, date, time, assignee, rewardPoints }) => {
+        try {
+            const config = getConfig();
+            const updates = {};
+            if (summary !== undefined)
+                updates.summary = summary;
+            if (status !== undefined)
+                updates.status = status;
+            if (date !== undefined)
+                updates.start = parseDate(date, config.timezone);
+            if (time !== undefined)
+                updates.startTime = time ? parseTime(time) : null;
+            if (rewardPoints !== undefined)
+                updates.rewardPoints = rewardPoints;
+            // Handle assignee
+            if (assignee !== undefined) {
+                if (assignee === null) {
+                    updates.categoryId = null;
+                }
+                else {
+                    updates.categoryId = (await resolveProfile(assignee)).id;
+                }
+            }
+            const chore = await updateChore(choreId, updates);
+            const statusText = status === "completed" ? " (marked complete)" : status === "pending" ? " (marked pending)" : "";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Updated chore: "${chore.attributes.summary}"${statusText}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // delete_chore tool
+    server.tool("delete_chore", `Delete a chore from Skylight.
+
+Use this when:
+- Removing an old or irrelevant chore
+- Deleting a chore that was added by mistake
+
+Parameters:
+- choreId (required): ID of the chore to delete (from get_chores)
+
+Note: This permanently removes the chore. For recurring chores, this may only delete one instance.`, {
+        choreId: z.string().describe("ID of the chore to delete"),
+    }, async ({ choreId }) => {
+        try {
+            await deleteChore(choreId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Deleted chore (ID: ${choreId})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=chores.js.map