@bmhall2/skylight-mcp 1.1.7 → 1.1.9

package/dist/tools/lists.js

@@ -27,9 +27,9 @@ async function resolveListId(listId, listName, defaultToGrocery = false) {
 }
 export function registerListTools(server) {
     // get_lists tool
-    server.tool("get_lists", `Get all lists from Skylight (grocery lists, to-do lists, etc.).
-
-Use this to see what lists are available before adding items.
+    server.tool("get_lists", `Get all lists from Skylight (grocery lists, to-do lists, etc.).
+
+Use this to see what lists are available before adding items.
 Returns list names, types (shopping/to_do), and item counts.`, {}, async () => {
         try {
             const lists = await getLists();
@@ -80,13 +80,13 @@ Returns list names, types (shopping/to_do), and item counts.`, {}, async () => {
         }
     });
     // get_list_items tool
-    server.tool("get_list_items", `Get items from a specific Skylight list.
-
-Use this to answer:
-- "What's on the grocery list?"
-- "Show me my to-do list"
-- "What items are on [list name]?"
-
+    server.tool("get_list_items", `Get items from a specific Skylight list.
+
+Use this to answer:
+- "What's on the grocery list?"
+- "Show me my to-do list"
+- "What items are on [list name]?"
+
 Returns items organized by section with their completion status.`, {
         listName: z
             .string()
@@ -219,17 +219,17 @@ Returns items organized by section with their completion status.`, {
         }
     });
     // create_list tool
-    server.tool("create_list", `Create a new list in Skylight.
-
-Use this when:
-- Creating a new shopping/grocery list
-- Creating a new to-do list
-
-Parameters:
-- label (required): Name of the list (e.g., "Vacation Packing", "Weekly Groceries")
-- kind (required): "shopping" for grocery/shopping lists, "to_do" for task lists
-- color: Optional color for the list
-
+    server.tool("create_list", `Create a new list in Skylight.
+
+Use this when:
+- Creating a new shopping/grocery list
+- Creating a new to-do list
+
+Parameters:
+- label (required): Name of the list (e.g., "Vacation Packing", "Weekly Groceries")
+- kind (required): "shopping" for grocery/shopping lists, "to_do" for task lists
+- color: Optional color for the list
+
 Returns: The created list details.`, {
         label: z.string().describe("Name of the list (e.g., 'Vacation Packing')"),
         kind: z.enum(["shopping", "to_do"]).describe("Type of list: 'shopping' or 'to_do'"),
@@ -254,19 +254,19 @@ Returns: The created list details.`, {
         }
     });
     // update_list tool
-    server.tool("update_list", `Update an existing list's name or settings.
-
-Use this when:
-- Renaming a list
-- Changing a list's type or color
-
-Parameters:
-- listId: ID of the list to update (use get_lists to find IDs)
-- listName: Name of the list to update (alternative to listId)
-- label: New name for the list
-- kind: New type ("shopping" or "to_do")
-- color: New color for the list
-
+    server.tool("update_list", `Update an existing list's name or settings.
+
+Use this when:
+- Renaming a list
+- Changing a list's type or color
+
+Parameters:
+- listId: ID of the list to update (use get_lists to find IDs)
+- listName: Name of the list to update (alternative to listId)
+- label: New name for the list
+- kind: New type ("shopping" or "to_do")
+- color: New color for the list
+
 Returns: The updated list details.`, {
         listId: z.string().optional().describe("ID of the list to update"),
         listName: z.string().optional().describe("Name of the list to update (alternative to listId)"),
@@ -307,16 +307,16 @@ Returns: The updated list details.`, {
         }
     });
     // delete_list tool
-    server.tool("delete_list", `Delete a list from Skylight.
-
-Use this when:
-- Removing an old or unused list
-- Deleting a temporary list
-
-Parameters:
-- listId: ID of the list to delete (use get_lists to find IDs)
-- listName: Name of the list to delete (alternative to listId)
-
+    server.tool("delete_list", `Delete a list from Skylight.
+
+Use this when:
+- Removing an old or unused list
+- Deleting a temporary list
+
+Parameters:
+- listId: ID of the list to delete (use get_lists to find IDs)
+- listName: Name of the list to delete (alternative to listId)
+
 Note: This permanently deletes the list and all its items.`, {
         listId: z.string().optional().describe("ID of the list to delete"),
         listName: z.string().optional().describe("Name of the list to delete (alternative to listId)"),
@@ -347,23 +347,23 @@ Note: This permanently deletes the list and all its items.`, {
         }
     });
     // create_list_item tool
-    server.tool("create_list_item", `Add an item to a Skylight list.
-
-Use this when:
-- Adding something to the grocery list: "Add milk to the shopping list"
-- Creating a to-do item: "Put 'call doctor' on my to-do list"
-- Adding items to any list
-
-Parameters:
-- label (required): The item text (e.g., "Milk", "Call doctor")
-- listId: ID of the list to add to
-- listName: Name of the list to add to (e.g., "Grocery List")
-- section: Category within the list (e.g., "Dairy", "Produce")
-
-If no list is specified, adds to the default grocery list.
-
-Returns: Confirmation of the added item.
-
+    server.tool("create_list_item", `Add an item to a Skylight list.
+
+Use this when:
+- Adding something to the grocery list: "Add milk to the shopping list"
+- Creating a to-do item: "Put 'call doctor' on my to-do list"
+- Adding items to any list
+
+Parameters:
+- label (required): The item text (e.g., "Milk", "Call doctor")
+- listId: ID of the list to add to
+- listName: Name of the list to add to (e.g., "Grocery List")
+- section: Category within the list (e.g., "Dairy", "Produce")
+
+If no list is specified, adds to the default grocery list.
+
+Returns: Confirmation of the added item.
+
 Related: Use get_lists to see available lists and their IDs.`, {
         label: z.string().describe("The item text to add (e.g., 'Milk', 'Call doctor')"),
         listId: z.string().optional().describe("ID of the list to add to"),
@@ -397,20 +397,20 @@ Related: Use get_lists to see available lists and their IDs.`, {
         }
     });
     // update_list_item tool
-    server.tool("update_list_item", `Update a list item (mark complete, rename, move to section).
-
-Use this when:
-- Marking an item as complete: "Check off milk from the list"
-- Renaming an item: "Change 'milk' to '2% milk'"
-- Moving an item to a different section
-
-Parameters:
-- itemId (required): ID of the item to update
-- listId (required): ID of the list containing the item
-- label: New text for the item
-- status: "completed" to check off, "pending" to uncheck
-- section: Move to a different section
-
+    server.tool("update_list_item", `Update a list item (mark complete, rename, move to section).
+
+Use this when:
+- Marking an item as complete: "Check off milk from the list"
+- Renaming an item: "Change 'milk' to '2% milk'"
+- Moving an item to a different section
+
+Parameters:
+- itemId (required): ID of the item to update
+- listId (required): ID of the list containing the item
+- label: New text for the item
+- status: "completed" to check off, "pending" to uncheck
+- section: Move to a different section
+
 Returns: The updated item details.`, {
         itemId: z.string().describe("ID of the item to update"),
         listId: z.string().describe("ID of the list containing the item"),
@@ -445,16 +445,16 @@ Returns: The updated item details.`, {
         }
     });
     // delete_list_item tool
-    server.tool("delete_list_item", `Remove an item from a list.
-
-Use this when:
-- Removing an item that was added by mistake
-- Deleting an item instead of marking it complete
-
-Parameters:
-- itemId (required): ID of the item to delete
-- listId (required): ID of the list containing the item
-
+    server.tool("delete_list_item", `Remove an item from a list.
+
+Use this when:
+- Removing an item that was added by mistake
+- Deleting an item instead of marking it complete
+
+Parameters:
+- itemId (required): ID of the item to delete
+- listId (required): ID of the list containing the item
+
 Note: This permanently removes the item. Use update_list_item with status="completed" to check it off instead.`, {
         itemId: z.string().describe("ID of the item to delete"),
         listId: z.string().describe("ID of the list containing the item"),

package/dist/tools/meals.js

@@ -5,12 +5,12 @@ import { formatErrorForMcp } from "../utils/errors.js";
 import { getConfig } from "../config.js";
 export function registerMealTools(server) {
     // get_meal_categories tool
-    server.tool("get_meal_categories", `Get meal categories (Breakfast, Lunch, Dinner, etc.) - Plus subscription required.
-
-Use this when:
-- Finding category IDs for scheduling meals
-- Seeing what meal times are available
-
+    server.tool("get_meal_categories", `Get meal categories (Breakfast, Lunch, Dinner, etc.) - Plus subscription required.
+
+Use this when:
+- Finding category IDs for scheduling meals
+- Seeing what meal times are available
+
 Returns: List of meal categories with IDs.`, {}, async () => {
         try {
             const categories = await getMealCategories();
@@ -34,12 +34,12 @@ Returns: List of meal categories with IDs.`, {}, async () => {
         }
     });
     // get_recipes tool
-    server.tool("get_recipes", `Get all saved recipes - Plus subscription required.
-
-Use this when:
-- Browsing available recipes
-- Finding a recipe ID for meal planning
-
+    server.tool("get_recipes", `Get all saved recipes - Plus subscription required.
+
+Use this when:
+- Browsing available recipes
+- Finding a recipe ID for meal planning
+
 Returns: List of recipes with their details.`, {}, async () => {
         try {
             const recipes = await getRecipes();
@@ -69,11 +69,11 @@ Returns: List of recipes with their details.`, {}, async () => {
         }
     });
     // get_recipe tool
-    server.tool("get_recipe", `Get details for a specific recipe - Plus subscription required.
-
-Parameters:
-- recipeId (required): ID of the recipe
-
+    server.tool("get_recipe", `Get details for a specific recipe - Plus subscription required.
+
+Parameters:
+- recipeId (required): ID of the recipe
+
 Returns: Recipe details including description.`, {
         recipeId: z.string().describe("ID of the recipe"),
     }, async ({ recipeId }) => {
@@ -97,17 +97,17 @@ Returns: Recipe details including description.`, {
         }
     });
     // create_recipe tool
-    server.tool("create_recipe", `Create a new recipe - Plus subscription required.
-
-Use this when:
-- Adding a new family recipe
-- Saving a meal for meal planning
-
-Parameters:
-- summary (required): Recipe name
-- description: Recipe details or instructions
-- mealCategoryId: Category ID (use get_meal_categories)
-
+    server.tool("create_recipe", `Create a new recipe - Plus subscription required.
+
+Use this when:
+- Adding a new family recipe
+- Saving a meal for meal planning
+
+Parameters:
+- summary (required): Recipe name
+- description: Recipe details or instructions
+- mealCategoryId: Category ID (use get_meal_categories)
+
 Returns: The created recipe.`, {
         summary: z.string().describe("Recipe name (e.g., 'Spaghetti Bolognese')"),
         description: z.string().optional().describe("Recipe details or instructions"),
@@ -132,13 +132,13 @@ Returns: The created recipe.`, {
         }
     });
     // update_recipe tool
-    server.tool("update_recipe", `Update an existing recipe - Plus subscription required.
-
-Parameters:
-- recipeId (required): ID of the recipe
-- summary: New name
-- description: New description
-
+    server.tool("update_recipe", `Update an existing recipe - Plus subscription required.
+
+Parameters:
+- recipeId (required): ID of the recipe
+- summary: New name
+- description: New description
+
 Returns: The updated recipe.`, {
         recipeId: z.string().describe("ID of the recipe to update"),
         summary: z.string().optional().describe("New recipe name"),
@@ -168,11 +168,11 @@ Returns: The updated recipe.`, {
         }
     });
     // delete_recipe tool
-    server.tool("delete_recipe", `Delete a recipe - Plus subscription required.
-
-Parameters:
-- recipeId (required): ID of the recipe to delete
-
+    server.tool("delete_recipe", `Delete a recipe - Plus subscription required.
+
+Parameters:
+- recipeId (required): ID of the recipe to delete
+
 Note: This permanently removes the recipe.`, {
         recipeId: z.string().describe("ID of the recipe to delete"),
     }, async ({ recipeId }) => {
@@ -190,15 +190,15 @@ Note: This permanently removes the recipe.`, {
         }
     });
     // add_recipe_to_grocery_list tool
-    server.tool("add_recipe_to_grocery_list", `Add a recipe's ingredients to the grocery list - Plus subscription required.
-
-Use this when:
-- Planning to make a recipe and need to buy ingredients
-- Adding meal ingredients to shopping list
-
-Parameters:
-- recipeId (required): ID of the recipe
-
+    server.tool("add_recipe_to_grocery_list", `Add a recipe's ingredients to the grocery list - Plus subscription required.
+
+Use this when:
+- Planning to make a recipe and need to buy ingredients
+- Adding meal ingredients to shopping list
+
+Parameters:
+- recipeId (required): ID of the recipe
+
 Returns: Confirmation that ingredients were added.`, {
         recipeId: z.string().describe("ID of the recipe"),
     }, async ({ recipeId }) => {
@@ -221,16 +221,16 @@ Returns: Confirmation that ingredients were added.`, {
         }
     });
     // get_meal_sittings tool
-    server.tool("get_meal_sittings", `Get scheduled meals for a date range - Plus subscription required.
-
-Use this when:
-- Viewing the meal plan for the week
-- Checking what's scheduled for dinner
-
-Parameters:
-- date: Start date (defaults to today)
-- dateEnd: End date (defaults to 7 days from start)
-
+    server.tool("get_meal_sittings", `Get scheduled meals for a date range - Plus subscription required.
+
+Use this when:
+- Viewing the meal plan for the week
+- Checking what's scheduled for dinner
+
+Parameters:
+- date: Start date (defaults to today)
+- dateEnd: End date (defaults to 7 days from start)
+
 Returns: List of scheduled meals.`, {
         date: z.string().optional().describe("Start date (YYYY-MM-DD or 'today')"),
         dateEnd: z.string().optional().describe("End date (YYYY-MM-DD)"),
@@ -275,17 +275,17 @@ Returns: List of scheduled meals.`, {
         }
     });
     // create_meal_sitting tool
-    server.tool("create_meal_sitting", `Schedule a meal for a specific date - Plus subscription required.
-
-Use this when:
-- Planning meals for the week
-- Scheduling a recipe for dinner
-
-Parameters:
-- date (required): Date for the meal (YYYY-MM-DD)
-- mealCategoryId (required): Meal category ID (use get_meal_categories)
-- recipeId: Recipe ID to schedule (optional)
-
+    server.tool("create_meal_sitting", `Schedule a meal for a specific date - Plus subscription required.
+
+Use this when:
+- Planning meals for the week
+- Scheduling a recipe for dinner
+
+Parameters:
+- date (required): Date for the meal (YYYY-MM-DD)
+- mealCategoryId (required): Meal category ID (use get_meal_categories)
+- recipeId: Recipe ID to schedule (optional)
+
 Returns: The created meal sitting.`, {
         date: z.string().describe("Date for the meal (YYYY-MM-DD or 'today', 'tomorrow')"),
         mealCategoryId: z.string().describe("Meal category ID (e.g., ID for 'Dinner')"),

package/dist/tools/misc.js

@@ -2,13 +2,13 @@ import { getAvatars, getColors } from "../api/endpoints/misc.js";
 import { formatErrorForMcp } from "../utils/errors.js";
 export function registerMiscTools(server) {
     // get_avatars tool
-    server.tool("get_avatars", `Get available avatar options for Skylight profiles.
-
-Use this when:
-- Setting up a new family member profile
-- Changing someone's profile picture
-- Exploring available avatar options
-
+    server.tool("get_avatars", `Get available avatar options for Skylight profiles.
+
+Use this when:
+- Setting up a new family member profile
+- Changing someone's profile picture
+- Exploring available avatar options
+
 Returns: List of available avatars with their IDs and details.`, {}, async () => {
         try {
             const avatars = await getAvatars();
@@ -50,13 +50,13 @@ Returns: List of available avatars with their IDs and details.`, {}, async () =>
         }
     });
     // get_colors tool
-    server.tool("get_colors", `Get available color options for Skylight profiles and lists.
-
-Use this when:
-- Choosing a color for a family member profile
-- Setting a list color
-- Exploring available color options
-
+    server.tool("get_colors", `Get available color options for Skylight profiles and lists.
+
+Use this when:
+- Choosing a color for a family member profile
+- Setting a list color
+- Exploring available color options
+
 Returns: List of available colors with their IDs and hex values.`, {}, async () => {
         try {
             const colors = await getColors();

package/dist/tools/photos.js

@@ -2,12 +2,12 @@ import { getAlbums } from "../api/endpoints/photos.js";
 import { formatErrorForMcp } from "../utils/errors.js";
 export function registerPhotoTools(server) {
     // get_albums tool
-    server.tool("get_albums", `Get photo albums from Skylight - Plus subscription required.
-
-Use this when:
-- Viewing available photo albums
-- Getting album IDs for photo management
-
+    server.tool("get_albums", `Get photo albums from Skylight - Plus subscription required.
+
+Use this when:
+- Viewing available photo albums
+- Getting album IDs for photo management
+
 Returns: List of photo albums with their IDs.`, {}, async () => {
         try {
             const albums = await getAlbums();

package/dist/tools/rewards.js

@@ -4,13 +4,13 @@ import { findCategoryByName } from "../api/endpoints/categories.js";
 import { formatErrorForMcp } from "../utils/errors.js";
 export function registerRewardTools(server) {
     // get_rewards tool
-    server.tool("get_rewards", `Get available rewards that can be redeemed with reward points.
-
-For family gamification - shows rewards that family members can earn.
-
-Use this to answer:
-- "What rewards can we redeem?"
-- "What can the kids earn?"
+    server.tool("get_rewards", `Get available rewards that can be redeemed with reward points.
+
+For family gamification - shows rewards that family members can earn.
+
+Use this to answer:
+- "What rewards can we redeem?"
+- "What can the kids earn?"
 - "Show available rewards"`, {
         redeemedSince: z
             .string()
@@ -65,13 +65,13 @@ Use this to answer:
         }
     });
     // get_reward_points tool
-    server.tool("get_reward_points", `Get reward points balance for family members.
-
-Shows how many reward points each family member has earned.
-
-Use this to answer:
-- "How many points does [name] have?"
-- "Show reward points balance"
+    server.tool("get_reward_points", `Get reward points balance for family members.
+
+Shows how many reward points each family member has earned.
+
+Use this to answer:
+- "How many points does [name] have?"
+- "Show reward points balance"
 - "Who has the most points?"`, {}, async () => {
         try {
             const points = await getRewardPoints();
@@ -119,20 +119,20 @@ Use this to answer:
         }
     });
     // create_reward tool
-    server.tool("create_reward", `Create a new reward that can be redeemed with points (Plus subscription required).
-
-Use this when:
-- Adding a new reward: "Create a reward for 30 minutes of screen time"
-- Setting up family incentives: "Add a pizza night reward worth 100 points"
-
-Parameters:
-- name (required): Reward name (e.g., "30 min Screen Time")
-- pointValue (required): Points needed to redeem this reward
-- description: Additional details about the reward
-- emojiIcon: Emoji to display with the reward
-- assignee: Family member name to assign this reward to
-- respawnOnRedemption: If true, reward can be redeemed multiple times
-
+    server.tool("create_reward", `Create a new reward that can be redeemed with points (Plus subscription required).
+
+Use this when:
+- Adding a new reward: "Create a reward for 30 minutes of screen time"
+- Setting up family incentives: "Add a pizza night reward worth 100 points"
+
+Parameters:
+- name (required): Reward name (e.g., "30 min Screen Time")
+- pointValue (required): Points needed to redeem this reward
+- description: Additional details about the reward
+- emojiIcon: Emoji to display with the reward
+- assignee: Family member name to assign this reward to
+- respawnOnRedemption: If true, reward can be redeemed multiple times
+
 Returns: The created reward details.`, {
         name: z.string().describe("Reward name (e.g., '30 min Screen Time')"),
         pointValue: z.number().describe("Points needed to redeem this reward"),
@@ -178,19 +178,19 @@ Returns: The created reward details.`, {
         }
     });
     // update_reward tool
-    server.tool("update_reward", `Update an existing reward (Plus subscription required).
-
-Use this when:
-- Changing point value: "Make the screen time reward cost 50 points"
-- Updating reward details: "Add a description to the pizza reward"
-
-Parameters:
-- rewardId (required): ID of the reward (from get_rewards)
-- name: New reward name
-- pointValue: New point cost
-- description: Updated description
-- emojiIcon: Updated emoji
-
+    server.tool("update_reward", `Update an existing reward (Plus subscription required).
+
+Use this when:
+- Changing point value: "Make the screen time reward cost 50 points"
+- Updating reward details: "Add a description to the pizza reward"
+
+Parameters:
+- rewardId (required): ID of the reward (from get_rewards)
+- name: New reward name
+- pointValue: New point cost
+- description: Updated description
+- emojiIcon: Updated emoji
+
 Returns: The updated reward details.`, {
         rewardId: z.string().describe("ID of the reward to update"),
         name: z.string().optional().describe("New reward name"),
@@ -229,15 +229,15 @@ Returns: The updated reward details.`, {
         }
     });
     // delete_reward tool
-    server.tool("delete_reward", `Delete a reward (Plus subscription required).
-
-Use this when:
-- Removing an old reward
-- Cleaning up unused rewards
-
-Parameters:
-- rewardId (required): ID of the reward to delete (from get_rewards)
-
+    server.tool("delete_reward", `Delete a reward (Plus subscription required).
+
+Use this when:
+- Removing an old reward
+- Cleaning up unused rewards
+
+Parameters:
+- rewardId (required): ID of the reward to delete (from get_rewards)
+
 Note: This permanently removes the reward.`, {
         rewardId: z.string().describe("ID of the reward to delete"),
     }, async ({ rewardId }) => {
@@ -260,16 +260,16 @@ Note: This permanently removes the reward.`, {
         }
     });
     // redeem_reward tool
-    server.tool("redeem_reward", `Redeem a reward using points (Plus subscription required).
-
-Use this when:
-- A family member wants to cash in points: "Redeem the screen time reward for Johnny"
-- Claiming an earned reward
-
-Parameters:
-- rewardId (required): ID of the reward to redeem (from get_rewards)
-- assignee: Family member redeeming the reward (uses their points)
-
+    server.tool("redeem_reward", `Redeem a reward using points (Plus subscription required).
+
+Use this when:
+- A family member wants to cash in points: "Redeem the screen time reward for Johnny"
+- Claiming an earned reward
+
+Parameters:
+- rewardId (required): ID of the reward to redeem (from get_rewards)
+- assignee: Family member redeeming the reward (uses their points)
+
 Returns: The redeemed reward details.`, {
         rewardId: z.string().describe("ID of the reward to redeem"),
         assignee: z.string().optional().describe("Family member redeeming the reward"),
@@ -304,15 +304,15 @@ Returns: The redeemed reward details.`, {
         }
     });
     // unredeem_reward tool
-    server.tool("unredeem_reward", `Cancel a reward redemption (Plus subscription required).
-
-Use this when:
-- A redemption was made by mistake
-- Undoing a reward claim
-
-Parameters:
-- rewardId (required): ID of the reward to unredeem
-
+    server.tool("unredeem_reward", `Cancel a reward redemption (Plus subscription required).
+
+Use this when:
+- A redemption was made by mistake
+- Undoing a reward claim
+
+Parameters:
+- rewardId (required): ID of the reward to unredeem
+
 Returns: The unredeemed reward details.`, {
         rewardId: z.string().describe("ID of the reward to unredeem"),
     }, async ({ rewardId }) => {