@starascendin/lifeos-mcp 0.7.4 → 0.7.5

package/dist/build-info.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.4";
-export declare const BUILD_TIME = "2026-02-18T19:45:47.374Z";
+export declare const VERSION = "0.7.5";
+export declare const BUILD_TIME = "2026-02-18T21:15:01.827Z";

package/dist/build-info.js

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Regenerated on every build.
-export const VERSION = "0.7.4";
-export const BUILD_TIME = "2026-02-18T19:45:47.374Z";
+export const VERSION = "0.7.5";
+export const BUILD_TIME = "2026-02-18T21:15:01.827Z";

package/dist/index.js

@@ -3036,6 +3036,80 @@ const TOOLS = [
             required: ["name"],
         },
     },
+    // ==================== Screen Time Tools ====================
+    {
+        name: "get_screentime_summary",
+        description: "Get daily Screen Time summaries with total usage time, per-app breakdown, and category usage. Returns an array of daily summaries sorted by date descending.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                userId: {
+                    type: "string",
+                    description: "Override the default user ID (optional)",
+                },
+                days: {
+                    type: "number",
+                    description: "Number of days to fetch (default 7)",
+                },
+            },
+        },
+    },
+    {
+        name: "get_screentime_top_apps",
+        description: "Get top apps by usage time for a date range, aggregated from raw sessions. Useful for identifying biggest time sinks.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                userId: {
+                    type: "string",
+                    description: "Override the default user ID (optional)",
+                },
+                days: {
+                    type: "number",
+                    description: "Number of days to look back (default 7)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max apps to return (default 10)",
+                },
+            },
+        },
+    },
+    {
+        name: "get_screentime_sessions",
+        description: "Get raw Screen Time sessions for a specific date, including app name, bundle ID, category, duration, and timestamps.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                userId: {
+                    type: "string",
+                    description: "Override the default user ID (optional)",
+                },
+                date: {
+                    type: "string",
+                    description: "Date in YYYY-MM-DD format (required)",
+                },
+            },
+            required: ["date"],
+        },
+    },
+    {
+        name: "get_screentime_categories",
+        description: "Get category-level Screen Time aggregation for a date range. Categories include Productivity, Social Networking, Entertainment, etc.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                userId: {
+                    type: "string",
+                    description: "Override the default user ID (optional)",
+                },
+                days: {
+                    type: "number",
+                    description: "Number of days to look back (default 7)",
+                },
+            },
+        },
+    },
     // MCP Server Info
     {
         name: "get_version",
@@ -3361,6 +3435,17 @@ const PROMPTS = [
             },
         ],
     },
+    {
+        name: "screentime-report",
+        description: "Screen time analysis: daily/weekly usage patterns, top time-sink apps, social media alerts, category breakdown.",
+        arguments: [
+            {
+                name: "days",
+                description: "Number of days to analyze (optional, defaults to 7)",
+                required: false,
+            },
+        ],
+    },
 ];
 // Prompt message templates keyed by prompt name
 const PROMPT_MESSAGES = {
@@ -4219,6 +4304,47 @@ Keep it direct and no-BS. This is a personal trainer report, not a gentle sugges
             },
         ];
     },
+    "screentime-report": (args) => {
+        const daysCount = args.days ? parseInt(args.days, 10) : 7;
+        return [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Generate a screen time report. Use the LifeOS MCP tools to gather:
+
+1. Call get_screentime_summary with days=${daysCount} for daily totals and app breakdowns
+2. Call get_screentime_top_apps with days=${daysCount} and limit=15 for top time-sink apps
+3. Call get_screentime_categories with days=${daysCount} for category-level aggregation
+
+Present a structured report:
+
+**USAGE OVERVIEW**
+- Total screen time over ${daysCount} days and daily average
+- Trend: increasing / decreasing / stable compared to prior period
+
+**TOP APPS**
+- Rank apps by total usage time
+- Flag any social media or entertainment apps in the top 5 with a warning
+
+**CATEGORY BREAKDOWN**
+- Show % split: Productivity vs Social vs Entertainment vs Communication vs Other
+- Highlight if Entertainment + Social > 40% of total
+
+**SOCIAL MEDIA ALERT**
+- If any social media app (Twitter/X, Instagram, TikTok, Reddit, Facebook, YouTube) exceeds 1 hour/day average, call it out explicitly
+- Estimate weekly hours wasted on social media
+
+**INSIGHTS**
+- 2-3 actionable observations
+- Compare productive vs non-productive time
+- Suggest one app to reduce and one habit to build
+
+Keep it concise and direct. This is an accountability report, not a feel-good summary.`,
+                },
+            },
+        ];
+    },
 };
 // Configuration: CLI flags take precedence over env vars
 // NOTE: HTTP routes are served from .convex.site, NOT .convex.cloud

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starascendin/lifeos-mcp",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "MCP server for LifeOS Project Management - manage projects, tasks, notes, and contacts via AI assistants",
   "type": "module",
   "main": "dist/index.js",