@energio/holded-mcp 1.0.0

package/dist/tools/team/time-tracking.js

@@ -0,0 +1,398 @@
+/**
+ * Time Tracking tools for Holded API
+ */
+import { makeApiRequest, toStructuredContent } from "../../services/api.js";
+import { ResponseFormat } from "../../constants.js";
+import { withErrorHandling } from "../utilities.js";
+import { ListAllTimeTrackingsInputSchema, ListEmployeeTimeTrackingsInputSchema, GetTimeTrackingInputSchema, CreateEmployeeTimeTrackingInputSchema, UpdateTimeTrackingInputSchema, DeleteTimeTrackingInputSchema, EmployeeClockInInputSchema, EmployeeClockOutInputSchema, EmployeePauseInputSchema, EmployeeUnpauseInputSchema, } from "../../schemas/team/time-tracking.js";
+/**
+ * Format time-trackings as markdown
+ */
+export function formatTimeTrackingsMarkdown(times) {
+    if (!times.length) {
+        return "No time-trackings found.";
+    }
+    const lines = ["# Time Trackings", "", `Found ${times.length} time entries:`, ""];
+    for (const time of times) {
+        lines.push(`## ${time.employeeName || `Employee ${time.employeeId}`}`);
+        lines.push(`- **ID**: ${time.id}`);
+        lines.push(`- **Date**: ${new Date(time.date * 1000).toLocaleDateString()}`);
+        lines.push(`- **Hours**: ${time.hours}`);
+        if (time.description)
+            lines.push(`- **Description**: ${time.description}`);
+        if (time.projectName)
+            lines.push(`- **Project**: ${time.projectName}`);
+        if (time.taskName)
+            lines.push(`- **Task**: ${time.taskName}`);
+        if (time.billable !== undefined)
+            lines.push(`- **Billable**: ${time.billable ? "Yes" : "No"}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single time-tracking as markdown
+ */
+export function formatTimeTrackingMarkdown(time) {
+    const lines = [`# Time Tracking Entry`, "", `**ID**: ${time.id}`, ""];
+    lines.push(`- **Employee**: ${time.employeeName || time.employeeId}`);
+    lines.push(`- **Date**: ${new Date(time.date * 1000).toLocaleDateString()}`);
+    lines.push(`- **Hours**: ${time.hours}`);
+    if (time.description)
+        lines.push(`- **Description**: ${time.description}`);
+    if (time.projectName)
+        lines.push(`- **Project**: ${time.projectName} (${time.projectId})`);
+    if (time.taskName)
+        lines.push(`- **Task**: ${time.taskName} (${time.taskId})`);
+    if (time.billable !== undefined)
+        lines.push(`- **Billable**: ${time.billable ? "Yes" : "No"}`);
+    return lines.join("\n");
+}
+/**
+ * Register all time-tracking-related tools
+ */
+export function registerTimeTrackingTools(server) {
+    // List All Time Trackings
+    server.registerTool("holded_team_list_all_time_trackings", {
+        title: "List All Holded Time Trackings",
+        description: `List all time-trackings for all employees from Holded.
+
+Args:
+  - page (number): Page number for pagination (default: 1, max 500 items per page)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of time-trackings with id, employee, date, hours, and description.`,
+        inputSchema: ListAllTimeTrackingsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { page, response_format } = params;
+        const queryParams = {};
+        if (page > 1) {
+            queryParams.page = page;
+        }
+        const times = await makeApiRequest("team", "employees/times", "GET", undefined, queryParams);
+        const textContent = response_format === ResponseFormat.MARKDOWN
+            ? formatTimeTrackingsMarkdown(times)
+            : JSON.stringify(times, null, 2);
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: { timeTrackings: times, count: times.length, page },
+        };
+    }));
+    // List Employee Time Trackings
+    server.registerTool("holded_team_list_employee_time_trackings", {
+        title: "List Holded Employee Time Trackings",
+        description: `List all time-trackings for a specific employee from Holded.
+
+Args:
+  - employee_id (string): The employee ID (required)
+  - page (number): Page number for pagination (default: 1, max 500 items per page)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of time-trackings for the employee.`,
+        inputSchema: ListEmployeeTimeTrackingsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { employee_id, page, response_format } = params;
+        const queryParams = {};
+        if (page > 1) {
+            queryParams.page = page;
+        }
+        const times = await makeApiRequest("team", `employees/${employee_id}/times`, "GET", undefined, queryParams);
+        const textContent = response_format === ResponseFormat.MARKDOWN
+            ? formatTimeTrackingsMarkdown(times)
+            : JSON.stringify(times, null, 2);
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: { timeTrackings: times, count: times.length, page },
+        };
+    }));
+    // Get Time Tracking
+    server.registerTool("holded_team_get_time_tracking", {
+        title: "Get Holded Time Tracking",
+        description: `Get a specific time-tracking by ID from Holded.
+
+Args:
+  - time_id (string): The time-tracking ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Time-tracking details including employee, date, hours, and description.`,
+        inputSchema: GetTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { time_id, response_format } = params;
+        const time = await makeApiRequest("team", `employees/times/${time_id}`, "GET");
+        const textContent = response_format === ResponseFormat.MARKDOWN
+            ? formatTimeTrackingMarkdown(time)
+            : JSON.stringify(time, null, 2);
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: toStructuredContent(time),
+        };
+    }));
+    // Create Employee Time Tracking
+    server.registerTool("holded_team_create_employee_time_tracking", {
+        title: "Create Holded Employee Time Tracking",
+        description: `Create a new time-tracking entry for an employee in Holded.
+
+Args:
+  - employee_id (string): The employee ID (required)
+  - startTmp (string): Start time as Unix timestamp string (required)
+  - endTmp (string): End time as Unix timestamp string (required)
+
+Returns:
+  The created time-tracking with its assigned ID.`,
+        inputSchema: CreateEmployeeTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { employee_id, startTmp, endTmp } = params;
+        const time = await makeApiRequest("team", `employees/${employee_id}/times`, "POST", { startTmp, endTmp });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Time-tracking created successfully.\n\n${JSON.stringify(time, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(time),
+        };
+    }));
+    // Update Time Tracking
+    server.registerTool("holded_team_update_time_tracking", {
+        title: "Update Holded Time Tracking",
+        description: `Update an existing time-tracking in Holded.
+
+Args:
+  - time_id (string): The time-tracking ID to update (required)
+  - startTmp (string): Start time as Unix timestamp string (required)
+  - endTmp (string): End time as Unix timestamp string (required)
+
+Returns:
+  The updated time-tracking.`,
+        inputSchema: UpdateTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { time_id, startTmp, endTmp } = params;
+        const time = await makeApiRequest("team", `employees/times/${time_id}`, "PUT", { startTmp, endTmp });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Time-tracking updated successfully.\n\n${JSON.stringify(time, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(time),
+        };
+    }));
+    // Delete Time Tracking
+    server.registerTool("holded_team_delete_time_tracking", {
+        title: "Delete Holded Time Tracking",
+        description: `Delete a time-tracking from Holded.
+
+Args:
+  - time_id (string): The time-tracking ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        inputSchema: DeleteTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { time_id } = params;
+        await makeApiRequest("team", `employees/times/${time_id}`, "DELETE");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Time-tracking ${time_id} deleted successfully.`,
+                },
+            ],
+            structuredContent: { deleted: true, id: time_id },
+        };
+    }));
+    // Employee Clock In
+    server.registerTool("holded_team_employee_clock_in", {
+        title: "Employee Clock In",
+        description: `Start counting employee time-tracking in Holded.
+
+Args:
+  - employee_id (string): The employee ID to clock in (required)
+  - location (string): Location name (optional)
+
+Returns:
+  Confirmation with status, info, and time-tracking ID.`,
+        inputSchema: EmployeeClockInInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { employee_id, location } = params;
+        const requestData = {};
+        if (location) {
+            requestData.location = location;
+        }
+        const result = await makeApiRequest("team", `employees/${employee_id}/times/clockin`, "POST", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Employee clocked in successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+            structuredContent: { clockedIn: true, employeeId: employee_id, ...result },
+        };
+    }));
+    // Employee Clock Out
+    server.registerTool("holded_team_employee_clock_out", {
+        title: "Employee Clock Out",
+        description: `End counting employee time-tracking in Holded.
+
+Args:
+  - employee_id (string): The employee ID to clock out (required)
+  - latitude (string): Latitude (e.g., -7.45556) (optional)
+  - longitude (string): Longitude (e.g., 55.55765) (optional)
+
+Returns:
+  Confirmation with status, info, and time-tracking ID.`,
+        inputSchema: EmployeeClockOutInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { employee_id, latitude, longitude } = params;
+        const requestData = {};
+        if (latitude) {
+            requestData.latitude = latitude;
+        }
+        if (longitude) {
+            requestData.longitude = longitude;
+        }
+        const result = await makeApiRequest("team", `employees/${employee_id}/times/clockout`, "POST", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Employee clocked out successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+            structuredContent: { clockedOut: true, employeeId: employee_id, ...result },
+        };
+    }));
+    // Employee Pause
+    server.registerTool("holded_team_employee_pause", {
+        title: "Employee Time-Tracking Pause",
+        description: `Pause employee time-tracking in Holded.
+
+Args:
+  - employee_id (string): The employee ID to pause (required)
+  - latitude (string): Latitude (e.g., -7.45556) (optional)
+  - longitude (string): Longitude (e.g., 55.55765) (optional)
+
+Returns:
+  Confirmation with status, info, and time-tracking ID.`,
+        inputSchema: EmployeePauseInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { employee_id, latitude, longitude } = params;
+        const requestData = {};
+        if (latitude) {
+            requestData.latitude = latitude;
+        }
+        if (longitude) {
+            requestData.longitude = longitude;
+        }
+        const result = await makeApiRequest("team", `employees/${employee_id}/times/pause`, "POST", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Employee time-tracking paused successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+            structuredContent: { paused: true, employeeId: employee_id, ...result },
+        };
+    }));
+    // Employee Unpause
+    server.registerTool("holded_team_employee_unpause", {
+        title: "Employee Time-Tracking Unpause",
+        description: `Unpause employee time-tracking in Holded.
+
+Args:
+  - employee_id (string): The employee ID to unpause (required)
+  - latitude (string): Latitude (e.g., -7.45556) (optional)
+  - longitude (string): Longitude (e.g., 55.55765) (optional)
+
+Returns:
+  Confirmation with status, info, and time-tracking ID.`,
+        inputSchema: EmployeeUnpauseInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { employee_id, latitude, longitude } = params;
+        const requestData = {};
+        if (latitude) {
+            requestData.latitude = latitude;
+        }
+        if (longitude) {
+            requestData.longitude = longitude;
+        }
+        const result = await makeApiRequest("team", `employees/${employee_id}/times/unpause`, "POST", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Employee time-tracking unpaused successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+            structuredContent: { unpaused: true, employeeId: employee_id, ...result },
+        };
+    }));
+}
+//# sourceMappingURL=time-tracking.js.map

package/dist/tools/team/time-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-tracking.js","sourceRoot":"","sources":["../../../src/tools/team/time-tracking.ts"],"names":[],"mappings":"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"}

package/dist/tools/utilities.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared utilities for tool handlers
+ */
+import { ResponseFormat } from "../constants.js";
+/**
+ * Build a standard tool response with both text and structured content.
+ *
+ * @param data - The response data
+ * @param format - MARKDOWN or JSON
+ * @param formatter - Function that renders data as markdown text
+ * @returns MCP tool result with content and structuredContent
+ */
+export declare function buildToolResponse<T>(data: T, format: ResponseFormat, formatter: (data: T) => string, structuredContent?: Record<string, unknown>): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+};
+/**
+ * Tool result type returned by MCP tool handlers.
+ */
+export interface ToolResult {
+    [key: string]: unknown;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+/**
+ * Wrap a tool handler in try/catch error handling.
+ *
+ * On success returns the handler's result.
+ * On error returns a user-friendly error message with isError: true.
+ */
+export declare function withErrorHandling(handler: (params: Record<string, unknown>) => Promise<ToolResult>): (input: unknown) => Promise<ToolResult>;
+/**
+ * Convert top-level snake_case keys to camelCase.
+ * Does NOT recurse into nested objects.
+ * Preserves keys that are already camelCase.
+ */
+export declare function snakeToCamel(obj: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/tools/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/tools/utilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAU3F;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAEzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,GAChE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAWzC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB"}

package/dist/tools/utilities.js

@@ -0,0 +1,55 @@
+/**
+ * Shared utilities for tool handlers
+ */
+import { ResponseFormat } from "../constants.js";
+import { handleApiError, toStructuredContent } from "../services/api.js";
+/**
+ * Build a standard tool response with both text and structured content.
+ *
+ * @param data - The response data
+ * @param format - MARKDOWN or JSON
+ * @param formatter - Function that renders data as markdown text
+ * @returns MCP tool result with content and structuredContent
+ */
+export function buildToolResponse(data, format, formatter, structuredContent) {
+    const text = format === ResponseFormat.MARKDOWN
+        ? formatter(data)
+        : JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: structuredContent ?? toStructuredContent(data),
+    };
+}
+/**
+ * Wrap a tool handler in try/catch error handling.
+ *
+ * On success returns the handler's result.
+ * On error returns a user-friendly error message with isError: true.
+ */
+export function withErrorHandling(handler) {
+    return async (input) => {
+        try {
+            return await handler(input);
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }],
+                isError: true,
+            };
+        }
+    };
+}
+/**
+ * Convert top-level snake_case keys to camelCase.
+ * Does NOT recurse into nested objects.
+ * Preserves keys that are already camelCase.
+ */
+export function snakeToCamel(obj) {
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        const camelKey = key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+        result[camelKey] = obj[key];
+    }
+    return result;
+}
+//# sourceMappingURL=utilities.js.map

package/dist/tools/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../src/tools/utilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAO,EACP,MAAsB,EACtB,SAA8B,EAC9B,iBAA2C;IAE3C,MAAM,IAAI,GACR,MAAM,KAAK,cAAc,CAAC,QAAQ;QAChC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEpC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,iBAAiB,EAAE,iBAAiB,IAAK,mBAAmB,CAAC,IAAI,CAA6B;KAC/F,CAAC;AACJ,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiE;IAEjE,OAAO,KAAK,EAAE,KAAc,EAAuB,EAAE;QACnD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,KAAgC,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,GAA4B;IAE5B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}