mcp-grocy 2.2.0 → 2.5.0

package/build/tools/household/definitions.js

@@ -2,12 +2,13 @@ export const householdToolDefinitions = [
     // ==================== CHORE MANAGEMENT ====================
     {
         name: 'household_chores_get',
-        description: '[HOUSEHOLD/CHORES] Get all chores from your Grocy instance.',
+        description: '[HOUSEHOLD/CHORES] List **Grocy Chores** (recurring household routines: cleaning schedule, maintenance cadence). Not the same as Tasks—use household_tasks_get for one-off to-dos.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {},
-            required: []
-        }
+            required: [],
+        },
     },
     {
         name: 'household_chores_execute',
@@ -17,33 +18,34 @@ export const householdToolDefinitions = [
             properties: {
                 choreId: {
                     type: 'number',
-                    description: 'ID of the chore to track execution for. Use household_chores_get tool to find the correct chore ID.'
+                    description: 'ID of the chore to track execution for. Use household_chores_get tool to find the correct chore ID.',
                 },
                 executedBy: {
                     type: 'number',
-                    description: 'ID of the user who executed the chore (optional). Use system_users_get tool to find user IDs.'
+                    description: 'ID of the user who executed the chore (optional). Use system_users_get tool to find user IDs.',
                 },
                 trackedTime: {
                     type: 'string',
-                    description: 'Time when the chore was executed in YYYY-MM-DD HH:mm:ss format (optional, defaults to current time)'
+                    description: 'Time when the chore was executed in YYYY-MM-DD HH:mm:ss format (optional, defaults to current time)',
                 },
                 note: {
                     type: 'string',
-                    description: 'Optional note for the chore execution'
-                }
+                    description: 'Optional note for the chore execution',
+                },
             },
-            required: ['choreId']
-        }
+            required: ['choreId'],
+        },
     },
     // ==================== TASK MANAGEMENT ====================
     {
         name: 'household_tasks_get',
-        description: '[HOUSEHOLD/TASKS] Get all tasks from your Grocy instance.',
+        description: '[HOUSEHOLD/TASKS] List **Grocy Tasks** (discrete to-dos / task tracker). Not recurring Chores—use household_chores_get for scheduled recurring chores.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {},
-            required: []
-        }
+            required: [],
+        },
     },
     {
         name: 'household_tasks_complete',
@@ -53,25 +55,26 @@ export const householdToolDefinitions = [
             properties: {
                 taskId: {
                     type: 'number',
-                    description: 'ID of the task to complete. Use household_tasks_get tool to find the correct task ID.'
+                    description: 'ID of the task to complete. Use household_tasks_get tool to find the correct task ID.',
                 },
                 note: {
                     type: 'string',
-                    description: 'Optional note for the task completion'
-                }
+                    description: 'Optional note for the task completion',
+                },
             },
-            required: ['taskId']
-        }
+            required: ['taskId'],
+        },
     },
     // ==================== BATTERY MANAGEMENT ====================
     {
         name: 'household_batteries_get',
         description: '[HOUSEHOLD/BATTERIES] Get all batteries from your Grocy instance.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {},
-            required: []
-        }
+            required: [],
+        },
     },
     {
         name: 'household_batteries_charge',
@@ -81,19 +84,19 @@ export const householdToolDefinitions = [
             properties: {
                 batteryId: {
                     type: 'number',
-                    description: 'ID of the battery to charge. Use household_batteries_get tool to find the correct battery ID.'
+                    description: 'ID of the battery to charge. Use household_batteries_get tool to find the correct battery ID.',
                 },
                 trackedTime: {
                     type: 'string',
-                    description: 'Time when the battery was charged in YYYY-MM-DD HH:mm:ss format (optional, defaults to current time)'
+                    description: 'Time when the battery was charged in YYYY-MM-DD HH:mm:ss format (optional, defaults to current time)',
                 },
                 note: {
                     type: 'string',
-                    description: 'Optional note for the battery charge'
-                }
+                    description: 'Optional note for the battery charge',
+                },
             },
-            required: ['batteryId']
-        }
+            required: ['batteryId'],
+        },
     },
     {
         name: 'household_batteries_print_label',
@@ -103,11 +106,11 @@ export const householdToolDefinitions = [
             properties: {
                 batteryId: {
                     type: 'number',
-                    description: 'ID of the battery to print label for. Use household_batteries_get tool to find the correct battery ID.'
-                }
+                    description: 'ID of the battery to print label for. Use household_batteries_get tool to find the correct battery ID.',
+                },
             },
-            required: ['batteryId']
-        }
+            required: ['batteryId'],
+        },
     },
     // ==================== CHORE LABEL PRINTING ====================
     {
@@ -118,21 +121,22 @@ export const householdToolDefinitions = [
             properties: {
                 choreId: {
                     type: 'number',
-                    description: 'ID of the chore to print label for. Use household_chores_get tool to find the correct chore ID.'
-                }
+                    description: 'ID of the chore to print label for. Use household_chores_get tool to find the correct chore ID.',
+                },
             },
-            required: ['choreId']
-        }
+            required: ['choreId'],
+        },
     },
     // ==================== EQUIPMENT MANAGEMENT ====================
     {
         name: 'household_equipment_get',
-        description: '[HOUSEHOLD/EQUIPMENT] Get all equipment from your Grocy instance.',
+        description: '[HOUSEHOLD/EQUIPMENT] List **equipment** assets tracked in Grocy (appliances, tools—not chore definitions). For recurring chore definitions use household_chores_get.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {},
-            required: []
-        }
+            required: [],
+        },
     },
     // ==================== ACTION UTILITIES ====================
     {
@@ -144,14 +148,14 @@ export const householdToolDefinitions = [
                 entityType: {
                     type: 'string',
                     enum: ['chore', 'chores', 'task', 'tasks', 'battery', 'batteries'],
-                    description: 'Type of entity to undo action for'
+                    description: 'Type of entity to undo action for',
                 },
                 id: {
                     type: 'number',
-                    description: 'ID of the specific execution/completion/charge to undo'
-                }
+                    description: 'ID of the specific execution/completion/charge to undo',
+                },
             },
-            required: ['entityType', 'id']
-        }
-    }
+            required: ['entityType', 'id'],
+        },
+    },
 ];

package/build/tools/household/handlers.js

@@ -15,7 +15,7 @@ export class HouseholdToolHandlers extends BaseToolHandler {
             const body = {
                 tracked_time: trackedTime || timestamp,
                 ...(executedBy ? { done_by: executedBy } : {}),
-                ...(note ? { note } : {})
+                ...(note ? { note } : {}),
             };
             const result = await this.apiCall(`/chores/${choreId}/execute`, 'POST', body);
             return this.createSuccess(result, 'Chore execution tracked successfully');
@@ -50,7 +50,7 @@ export class HouseholdToolHandlers extends BaseToolHandler {
             const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 19);
             const body = {
                 tracked_time: trackedTime || timestamp,
-                ...(note ? { note } : {})
+                ...(note ? { note } : {}),
             };
             const result = await this.apiCall(`/batteries/${batteryId}/charge`, 'POST', body);
             return this.createSuccess(result, 'Battery charged successfully');

package/build/tools/household/index.js

@@ -19,7 +19,7 @@ export const householdModule = {
         // Equipment Management
         household_equipment_get: handlers.getEquipment,
         // Action Utilities
-        household_actions_undo: handlers.undoAction
-    }
+        household_actions_undo: handlers.undoAction,
+    },
 };
 export * from './definitions.js';