clokio-mcp 0.22.0 → 0.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -85,7 +85,7 @@ are marked mutating (deletes are `destructive`).
85
85
  | **Projects & clients** | list projects, project statuses, project custom fields, project contacts, get client, add client contact |
86
86
  | **Reference** | task statuses, task labels, locations, list webhooks (read-only), whoami |
87
87
  | **Employees** | list (name search), lookup by PIN, task-stats, inbox (mentions, new assignments, others' status changes), create, set status |
88
- | **Attendance** | daily, range, per-employee, monthly summary, clock in/out, break start/end, time entries (edit / delete your own), leaves, leave balances, **log time on a task**, start / stop / read the timer (see [Logging time](#logging-time)) |
88
+ | **Attendance** | daily, range, per-employee, monthly summary, clock in/out, break start/end, time entries (edit / delete your own), leaves, leave balances (always empty: Clokio does not track balances), **log time on a task**, start / stop / read the timer (see [Logging time](#logging-time)) |
89
89
  | **Documents** (see [Documents](#documents) for who a key acts as) | list, tree, search, get (Markdown / HTML / JSON), create, replace content, update meta, move, archive, restore, delete, templates + create from template, members (by `employee_code`) and teams (list/add/update/remove, shareable teams), public share link, comments (list/add/resolve/reopen), versions (list/get/restore), attachments (list/upload/download) |
90
90
  | **Tickets** (see [Tickets](#tickets)) | list (filters + cursor), get (with its newest messages; internal notes labelled, everything the customer wrote wrapped as untrusted), more messages, **reply to the customer** (fresh `Idempotency-Key` per call, `destructive`), internal note (with mentions), update state / assignee, add / remove one label, contacts list / get / update, inboxes, ticket labels, saved replies, download a file a customer sent, save a reply draft |
91
91
 
@@ -365,7 +365,10 @@ export function registerAttendanceTools(server, config) {
365
365
  from: z.string().describe('YYYY-MM-DD, required'),
366
366
  to: z.string().describe('YYYY-MM-DD, required, on or after from'),
367
367
  employee: employeeCode.optional().describe("An employee_code, e.g. '00080'"),
368
- status: z.enum(['PENDING', 'APPROVED', 'REJECTED']).optional(),
368
+ status: z
369
+ .enum(['PENDING', 'APPROVED', 'REJECTED', 'REVOKED', 'CANCELLED'])
370
+ .optional()
371
+ .describe('REVOKED = approved, then withdrawn by an approver; CANCELLED = withdrawn by the employee before a decision'),
369
372
  per_page: z.number().int().min(1).max(100).optional(),
370
373
  },
371
374
  handler: (args, cfg) => request(cfg, '/leaves', {
@@ -380,8 +383,10 @@ export function registerAttendanceTools(server, config) {
380
383
  });
381
384
  registerTool(server, config, {
382
385
  name: 'clokio_get_leave_balances',
383
- description: "One employee's leave balances (quota, used, remaining per leave type). The employee_code is REQUIRED - " +
384
- 'there is no org-wide form of this call.',
386
+ description: 'Clokio does NOT track leave balances today: this always returns an empty `balances` list ' +
387
+ '(no quotas exist, and approving or revoking a leave changes no balance). Do not read the empty list as ' +
388
+ '"zero days left". To count days taken, use clokio_list_leaves with status APPROVED and sum number_of_days. ' +
389
+ 'The employee_code is REQUIRED; there is no org-wide form of this call.',
385
390
  schema: {
386
391
  employee: employeeCode.describe("The employee_code, e.g. '00080'"),
387
392
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clokio-mcp",
3
- "version": "0.22.0",
3
+ "version": "0.22.1",
4
4
  "description": "Model Context Protocol (MCP) server for Clokio - manage tasks, projects, clients, employees, attendance and documents from Claude and any MCP client.",
5
5
  "type": "module",
6
6
  "bin": {