@davidwoods/skylight-mcp 1.7.0 → 1.8.0

package/dist/tools/tasks.js

@@ -1,17 +1,52 @@
 import { z } from "zod";
-import { createTaskBoxItem } from "../api/endpoints/taskbox.js";
+import { createTaskBoxItem, listTaskBoxItems } from "../api/endpoints/taskbox.js";
 import { formatErrorForMcp } from "../utils/errors.js";
 export function registerTaskTools(server) {
+    // get_task_box tool
+    server.tool("get_task_box", `List the Skylight task box.
+
+The task box is a library of reusable chore and routine templates (for example "Take out trash" or "Brush teeth"), not scheduled work. Items have no assignee and no date; scheduling one creates a chore, which get_chores and get_week_overview show.
+
+Use this when the user asks what is in the task box, or before adding a task to avoid a duplicate.`, {}, async () => {
+        try {
+            const items = await listTaskBoxItems();
+            if (items.length === 0) {
+                return { content: [{ type: "text", text: "The task box is empty." }] };
+            }
+            const line = (item) => {
+                const a = item.attributes;
+                const extras = [];
+                if (a.reward_points)
+                    extras.push(`${a.reward_points} points`);
+                const emoji = a.emoji_icon ? `${a.emoji_icon} ` : "";
+                return `- ${emoji}${a.summary}${extras.length ? ` (${extras.join(", ")})` : ""}`;
+            };
+            const chores = items.filter((i) => !i.attributes.routine);
+            const routines = items.filter((i) => i.attributes.routine);
+            const parts = [`Task box: ${items.length} items`];
+            if (chores.length)
+                parts.push("", "Chores:", ...chores.map(line));
+            if (routines.length)
+                parts.push("", "Routines:", ...routines.map(line));
+            return { content: [{ type: "text", text: parts.join("\n") }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
     // 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/tools/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,mBAAmB;IACnB,MAAM,CAAC,IAAI,CACT,aAAa,EACb;;;;;;;;;8DAS0D,EAC1D;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAChD,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4CAA4C,CAAC;QACzD,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;QACxE,OAAO,EAAE,CAAC;aACP,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,yBAAyB,CAAC;KACvC,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;gBACnC,OAAO;gBACP,SAAS,EAAE,KAAK;gBAChB,YAAY;gBACZ,OAAO,EAAE,OAAO,IAAI,KAAK;aAC1B,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;YAE7D,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;YAChE,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YAElE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;qBACvB;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;AACJ,CAAC"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"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"}

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. If using email/password auth, retry with valid SKYLIGHT_EMAIL and SKYLIGHT_PASSWORD
-2. If using a manual token, capture fresh API traffic using a proxy tool
-3. Update your SKYLIGHT_TOKEN environment variable if you are using manual token auth
-
+        return `Authentication Error: ${error.message}
+
+Your Skylight token may have expired. To fix this:
+1. If using email/password auth, retry with valid SKYLIGHT_EMAIL and SKYLIGHT_PASSWORD
+2. If using a manual token, capture fresh API traffic using a proxy tool
+3. Update your SKYLIGHT_TOKEN environment variable if you are using manual token auth
+
 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,78 +1,78 @@
-{
-  "name": "@davidwoods/skylight-mcp",
-  "version": "1.7.0",
-  "description": "Unofficial MCP server for Skylight Calendar: local (stdio) and hosted (Cloudflare Workers), with browser-paste OAuth sign-in and an encrypted credential store",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "skylight-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "THIRD_PARTY_NOTICES.md"
-  ],
-  "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",
-    "typecheck:worker": "tsc -p tsconfig.worker.json",
-    "worker:dev": "wrangler dev",
-    "worker:deploy": "wrangler deploy",
-    "worker:deploy:local": "wrangler deploy -c wrangler.local.jsonc",
-    "worker:setup": "node scripts/setup-worker.mjs",
-    "prepublishOnly": "npm run typecheck && npm run lint && vitest run && npm run build",
-    "test:live": "vitest run --config vitest.live.config.ts"
-  },
-  "keywords": [
-    "mcp",
-    "skylight",
-    "calendar",
-    "model-context-protocol",
-    "claude",
-    "ai",
-    "family",
-    "chores"
-  ],
-  "author": "David Woods",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/dwooods/skylight-mcp.git"
-  },
-  "dependencies": {
-    "@cloudflare/workers-oauth-provider": "^1.2.4",
-    "@modelcontextprotocol/sdk": "^1.32.2",
-    "zod": "^4.6.7"
-  },
-  "devDependencies": {
-    "@cloudflare/workers-types": "^5.20261029.1",
-    "@types/node": "^22.20.5",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.57.0",
-    "openapi-typescript": "^7.0.0",
-    "tsx": "^4.7.0",
-    "typescript": "^5.4.5",
-    "vite": "^8.3.5",
-    "vitest": "^5.0.5",
-    "wrangler": "^4.156.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "homepage": "https://github.com/dwooods/skylight-mcp#readme",
-  "bugs": {
-    "url": "https://github.com/dwooods/skylight-mcp/issues"
-  }
-}
+{
+  "name": "@davidwoods/skylight-mcp",
+  "version": "1.8.0",
+  "description": "Unofficial MCP server for Skylight Calendar: local (stdio) and hosted (Cloudflare Workers), with browser-paste OAuth sign-in and an encrypted credential store",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "skylight-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "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",
+    "typecheck:worker": "tsc -p tsconfig.worker.json",
+    "worker:dev": "wrangler dev",
+    "worker:deploy": "wrangler deploy",
+    "worker:deploy:local": "wrangler deploy -c wrangler.local.jsonc",
+    "worker:setup": "node scripts/setup-worker.mjs",
+    "prepublishOnly": "npm run typecheck && npm run lint && vitest run && npm run build",
+    "test:live": "vitest run --config vitest.live.config.ts"
+  },
+  "keywords": [
+    "mcp",
+    "skylight",
+    "calendar",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "family",
+    "chores"
+  ],
+  "author": "David Woods",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dwooods/skylight-mcp.git"
+  },
+  "dependencies": {
+    "@cloudflare/workers-oauth-provider": "^1.2.4",
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^5.20261029.1",
+    "@types/node": "^22.20.5",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "openapi-typescript": "^7.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.5",
+    "vite": "^8.3.5",
+    "vitest": "^5.0.5",
+    "wrangler": "^4.156.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "homepage": "https://github.com/dwooods/skylight-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/dwooods/skylight-mcp/issues"
+  }
+}