clokio-mcp 0.13.1 → 0.13.3

package/README.md

@@ -75,7 +75,7 @@ are marked mutating (deletes are `destructive`).
 | **Tasks** | list (with `compact` / `sort` / `updated_since`), get (with `comments_limit`), create, update, delete, bulk update, set assignees, list/add/edit comments, list/upload/download attachments, activity, list/add/remove dependencies, set custom field |
 | **Projects & clients** | list projects, project statuses, project custom fields, project contacts, get client, add client contact |
 | **Reference** | task statuses, task labels, locations, list webhooks (read-only), whoami |
-| **Employees** | list (name search), lookup by PIN, task-stats, inbox, create, set status |
+| **Employees** | list (name search), lookup by PIN, task-stats, inbox (mentions, new assignments, others' status changes), create, set status |
 | **Attendance** | daily, range, per-employee, monthly summary, clock in/out, break start/end, time entries, leaves, leave balances |
 
 ### Conventions

package/dist/tools/employees.js

@@ -73,16 +73,25 @@ export function registerEmployeeTools(server, config) {
     });
     registerTool(server, config, {
         name: 'clokio_get_inbox',
-        description: 'What needs one person\'s attention: mentions_waiting (comments that @-mention them and that they have ' +
-            'NOT replied to yet) and newly_assigned (tasks assigned to them in the window). This is how you find ' +
-            'that someone asked a question, without scanning the board. `since` defaults to 14 days (max 90). ' +
-            'To answer for the KEY OWNER, pass their own employee_code (from clokio_whoami).',
+        description: 'What needs one person\'s attention, in three lists: mentions_waiting (comments that @-mention them and ' +
+            'that they have NOT replied to yet; mentions on closed tasks are excluded), newly_assigned (tasks ' +
+            'assigned to them in the window), and status_changes (status moves on tasks they hold or created, made ' +
+            'by SOMEONE ELSE - their own moves and task-creation rows are excluded). This is how you find that ' +
+            'someone asked a question or moved your work, without scanning the board. `since` defaults to 14 days ' +
+            '(max 90). status_changes is capped by `limit` (default 100, max 500); the response sets ' +
+            'status_changes_truncated=true when more exist past the cap. To answer for the KEY OWNER, pass their ' +
+            'own employee_code (from clokio_whoami).',
         schema: {
             employee_code: employeeCode,
             since: z.string().optional().describe('ISO-8601 or YYYY-MM-DD. Only items after this. Default 14 days ago'),
+            limit: z
+                .number()
+                .int()
+                .optional()
+                .describe('Max status_changes to return (default 100, max 500). status_changes_truncated flags overflow'),
         },
         handler: (args, cfg) => request(cfg, `/employees/${seg(args.employee_code)}/inbox`, {
-            query: { since: args.since },
+            query: { since: args.since, limit: args.limit },
         }),
     });
     registerTool(server, config, {

package/dist/tools/tasks.js

@@ -46,9 +46,11 @@ export function registerTaskTools(server, config) {
             compact: z
                 .boolean()
                 .optional()
-                .describe('STRONGLY PREFERRED when scanning. Returns id, title, status, priority, due_date, project, ' +
-                'assignees, labels and updated_at only - dropping the HTML description, which is most of the ' +
-                'payload. Fetch the one task you actually need in full with clokio_get_task.'),
+                .describe('STRONGLY PREFERRED when scanning. Returns a slim row - id, title, status, priority, ' +
+                'due_date, parent_id, project_id, assignee_codes (employee_code strings), labels (names) ' +
+                'and updated_at - dropping the HTML description and flattening the nested project/assignee ' +
+                'objects to ids. Resolve a project_id with clokio_list_projects, and fetch the one task you ' +
+                'actually need in full with clokio_get_task (its URL is /tasks/{id}/view).'),
             sort: z
                 .enum([
                 'due_date',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clokio-mcp",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "Model Context Protocol (MCP) server for Clokio — manage tasks, projects, clients, employees and attendance from Claude and any MCP client.",
   "type": "module",
   "bin": {