@bmhall2/skylight-mcp 1.1.7 → 1.1.8

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 }) => {

package/dist/tools/tasks.js

@@ -3,15 +3,15 @@ import { createTaskBoxItem } from "../api/endpoints/taskbox.js";
 import { formatErrorForMcp } from "../utils/errors.js";
 export function registerTaskTools(server) {
     // create_task tool
-    server.tool("create_task", `Add a task to the Skylight task box.
-
-The task box holds unscheduled tasks that can later be assigned to specific dates.
-
-Use this when the user says:
-- "Add XYZ to my task list"
-- "Remind me to do ABC" (without a specific date)
-- "Put 'clean garage' on the task box"
-
+    server.tool("create_task", `Add a task to the Skylight task box.
+
+The task box holds unscheduled tasks that can later be assigned to specific dates.
+
+Use this when the user says:
+- "Add XYZ to my task list"
+- "Remind me to do ABC" (without a specific date)
+- "Put 'clean garage' on the task box"
+
 The task will appear on the Skylight display in the task box.`, {
         summary: z.string().describe("Task description"),
         emoji: z

package/dist/utils/errors.js

@@ -64,31 +64,31 @@ export class ParseError extends SkylightError {
  */
 export function formatErrorForMcp(error) {
     if (error instanceof AuthenticationError) {
-        return `Authentication Error: ${error.message}
-
-Your Skylight token may have expired. To fix this:
-1. Open the Skylight app on your device
-2. Capture fresh API traffic using a proxy tool
-3. Update your SKYLIGHT_TOKEN environment variable
-
+        return `Authentication Error: ${error.message}
+
+Your Skylight token may have expired. To fix this:
+1. Open the Skylight app on your device
+2. Capture fresh API traffic using a proxy tool
+3. Update your SKYLIGHT_TOKEN environment variable
+
 See the auth documentation for detailed steps.`;
     }
     if (error instanceof NotFoundError) {
-        return `Not Found: ${error.message}
-
-This could mean:
-- The requested item doesn't exist
-- Your frame ID is incorrect
+        return `Not Found: ${error.message}
+
+This could mean:
+- The requested item doesn't exist
+- Your frame ID is incorrect
 - The item was deleted from Skylight`;
     }
     if (error instanceof RateLimitError) {
-        return `Rate Limited: ${error.message}
-
+        return `Rate Limited: ${error.message}
+
 The Skylight API is temporarily limiting requests. Please wait a moment and try again.`;
     }
     if (error instanceof ConfigurationError) {
-        return `Configuration Error: ${error.message}
-
+        return `Configuration Error: ${error.message}
+
 Please check your environment variables are set correctly.`;
     }
     if (error instanceof SkylightError) {

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "@bmhall2/skylight-mcp",
-  "version": "1.1.7",
-  "description": "MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "skylight-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "tsx watch src/index.ts",
-    "test": "vitest",
-    "test:coverage": "vitest --coverage",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit",
-    "prepare": "npm run build",
-    "generate:types": "openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"
-  },
-  "keywords": [
-    "mcp",
-    "skylight",
-    "calendar",
-    "model-context-protocol",
-    "claude",
-    "ai",
-    "family",
-    "chores"
-  ],
-  "author": "Ben Hall <bmhall2@gmail.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/bmhall2/skylight-mcp.git"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.11.0",
-    "zod": "^3.24.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20.12.2",
-    "typescript": "^5.4.5",
-    "tsx": "^4.7.0",
-    "vitest": "^1.6.0",
-    "eslint": "^8.57.0",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "openapi-typescript": "^7.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "@bmhall2/skylight-mcp",
+  "version": "1.1.8",
+  "description": "MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "skylight-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "generate:types": "openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"
+  },
+  "keywords": [
+    "mcp",
+    "skylight",
+    "calendar",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "family",
+    "chores"
+  ],
+  "author": "Ben Hall <bmhall2@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bmhall2/skylight-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.2",
+    "typescript": "^5.4.5",
+    "tsx": "^4.7.0",
+    "vitest": "^1.6.0",
+    "eslint": "^8.57.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "openapi-typescript": "^7.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}