@energio/holded-mcp 1.0.0

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

@@ -0,0 +1,291 @@
+/**
+ * Project Time Tracking tools for Holded API
+ */
+import { makeApiRequest, toStructuredContent } from "../../services/api.js";
+import { ResponseFormat } from "../../constants.js";
+import { withErrorHandling } from "../utilities.js";
+import { ListProjectTimeTrackingsInputSchema, CreateProjectTimeTrackingInputSchema, UpdateProjectTimeTrackingInputSchema, DeleteProjectTimeTrackingInputSchema, GetProjectTimeTrackingInputSchema, ListAllProjectTimesInputSchema, } from "../../schemas/projects/time-tracking.js";
+/**
+ * Format project time-trackings as markdown
+ */
+export function formatProjectTimeTrackingsMarkdown(times) {
+    if (!times.length) {
+        return "No time-trackings found for this project.";
+    }
+    const lines = ["# Project Time Trackings", "", `Found ${times.length} time entries:`, ""];
+    for (const time of times) {
+        lines.push(`## Entry ${time.id}`);
+        lines.push(`- **ID**: ${time.id}`);
+        lines.push(`- **Date**: ${new Date(time.date * 1000).toLocaleDateString()}`);
+        lines.push(`- **Hours**: ${time.hours}`);
+        if (time.employeeName)
+            lines.push(`- **Employee**: ${time.employeeName}`);
+        if (time.description)
+            lines.push(`- **Description**: ${time.description}`);
+        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");
+}
+/**
+ * Register all project time-tracking-related tools
+ */
+export function registerProjectTimeTrackingTools(server) {
+    // List Project Time Trackings
+    server.registerTool("holded_projects_list_project_time_trackings", {
+        title: "List Holded Project Time Trackings",
+        description: `List all time-trackings for a specific project from Holded.
+
+Args:
+  - project_id (string): The project 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 project.`,
+        inputSchema: ListProjectTimeTrackingsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { project_id, page, response_format } = params;
+        const queryParams = {};
+        if (page > 1) {
+            queryParams.page = page;
+        }
+        const times = await makeApiRequest("projects", `projects/${project_id}/times`, "GET", undefined, queryParams);
+        const textContent = response_format === ResponseFormat.MARKDOWN
+            ? formatProjectTimeTrackingsMarkdown(times)
+            : JSON.stringify(times, null, 2);
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: { timeTrackings: times, count: times.length, page },
+        };
+    }));
+    // Create Project Time Tracking
+    server.registerTool("holded_projects_create_project_time_tracking", {
+        title: "Create Holded Project Time Tracking",
+        description: `Create a new time-tracking entry for a project in Holded.
+
+Args:
+  - project_id (string): The project ID (required)
+  - duration (number): Duration in seconds (required)
+  - costHour (number): Cost per hour (required)
+  - desc (string): Description of work (optional)
+  - userId (string): User/Employee ID (optional)
+  - taskId (string): Task ID (optional)
+
+Returns:
+  The created time-tracking with its assigned ID.`,
+        inputSchema: CreateProjectTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { project_id, ...timeData } = params;
+        const time = await makeApiRequest("projects", `projects/${project_id}/times`, "POST", timeData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Project time-tracking created successfully.\n\n${JSON.stringify(time, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(time),
+        };
+    }));
+    // Update Project Time Tracking
+    server.registerTool("holded_projects_update_project_time_tracking", {
+        title: "Update Holded Project Time Tracking",
+        description: `Update an existing time-tracking entry for a project in Holded.
+
+Args:
+  - project_id (string): The project ID (required)
+  - time_id (string): The time-tracking ID to update (required)
+  - duration (number): Duration in seconds (optional)
+  - costHour (number): Cost per hour (optional)
+  - desc (string): Description of work (optional)
+  - userId (string): User/Employee ID (optional)
+  - taskId (string): Task ID (optional)
+
+Returns:
+  The updated time-tracking.`,
+        inputSchema: UpdateProjectTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { project_id, time_id, ...updateData } = params;
+        const time = await makeApiRequest("projects", `projects/${project_id}/times/${time_id}`, "PUT", updateData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Project time-tracking updated successfully.\n\n${JSON.stringify(time, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(time),
+        };
+    }));
+    // Delete Project Time Tracking
+    server.registerTool("holded_projects_delete_project_time_tracking", {
+        title: "Delete Holded Project Time Tracking",
+        description: `Delete a time-tracking entry from a project in Holded.
+
+Args:
+  - project_id (string): The project ID (required)
+  - time_id (string): The time-tracking ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        inputSchema: DeleteProjectTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { project_id, time_id } = params;
+        await makeApiRequest("projects", `projects/${project_id}/times/${time_id}`, "DELETE");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Project time-tracking ${time_id} deleted successfully.`,
+                },
+            ],
+            structuredContent: { deleted: true, id: time_id, projectId: project_id },
+        };
+    }));
+    // Get Project Time Tracking
+    server.registerTool("holded_projects_get_project_time_tracking", {
+        title: "Get Holded Project Time Tracking",
+        description: `Get a specific time-tracking entry for a project from Holded.
+
+Args:
+  - project_id (string): The project ID (required)
+  - time_id (string): The time-tracking ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Time-tracking details including duration, description, cost, and other fields.`,
+        inputSchema: GetProjectTimeTrackingInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { project_id, time_id, response_format } = params;
+        const time = await makeApiRequest("projects", `projects/${project_id}/times/${time_id}`, "GET");
+        let textContent;
+        if (response_format === ResponseFormat.MARKDOWN) {
+            const lines = [`# Time Tracking Entry ${time.id}`, ""];
+            if (time.date)
+                lines.push(`- **Date**: ${new Date(time.date * 1000).toLocaleDateString()}`);
+            if (time.hours !== undefined)
+                lines.push(`- **Hours**: ${time.hours}`);
+            if (time.duration !== undefined)
+                lines.push(`- **Duration**: ${time.duration} seconds`);
+            if (time.description)
+                lines.push(`- **Description**: ${time.description}`);
+            if (time.employeeName)
+                lines.push(`- **Employee**: ${time.employeeName}`);
+            if (time.taskName)
+                lines.push(`- **Task**: ${time.taskName}`);
+            if (time.costHour !== undefined)
+                lines.push(`- **Cost/Hour**: ${time.costHour}`);
+            if (time.total !== undefined)
+                lines.push(`- **Total**: ${time.total}`);
+            if (time.billable !== undefined)
+                lines.push(`- **Billable**: ${time.billable ? "Yes" : "No"}`);
+            textContent = lines.join("\n");
+        }
+        else {
+            textContent = JSON.stringify(time, null, 2);
+        }
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: toStructuredContent(time),
+        };
+    }));
+    // List All Project Times
+    server.registerTool("holded_projects_list_all_times", {
+        title: "List All Holded Project Times",
+        description: `List time trackings in projects not archived from 18 months on.
+
+Args:
+  - start (number): Start date as Unix timestamp (optional)
+  - end (number): End date as Unix timestamp (optional)
+  - archived (boolean): Include archived projects (optional)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of projects with their time-tracking entries.`,
+        inputSchema: ListAllProjectTimesInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { start, end, archived, response_format } = params;
+        const queryParams = {};
+        if (start !== undefined) {
+            queryParams.start = start;
+        }
+        if (end !== undefined) {
+            queryParams.end = end;
+        }
+        if (archived !== undefined) {
+            queryParams.archived = archived;
+        }
+        const projects = await makeApiRequest("projects", "projects/times", "GET", undefined, queryParams);
+        let textContent;
+        if (response_format === ResponseFormat.MARKDOWN) {
+            if (!projects.length) {
+                textContent = "No project times found.";
+            }
+            else {
+                const lines = ["# All Project Times", "", `Found ${projects.length} projects:`, ""];
+                for (const project of projects) {
+                    lines.push(`## ${project.name} (${project.id})`);
+                    if (project.timeTracking && project.timeTracking.length > 0) {
+                        lines.push(`**Time Entries**: ${project.timeTracking.length}`);
+                        for (const time of project.timeTracking) {
+                            lines.push(`- ${time.desc || "Time entry"} (${time.duration}s, ${time.total || 0} total)`);
+                        }
+                    }
+                    else {
+                        lines.push("No time entries");
+                    }
+                    lines.push("");
+                }
+                textContent = lines.join("\n");
+            }
+        }
+        else {
+            textContent = JSON.stringify(projects, null, 2);
+        }
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: { projects, count: projects.length },
+        };
+    }));
+}
+//# sourceMappingURL=time-tracking.js.map

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

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

package/dist/tools/team/employees.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Employee tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Employee } from "../../types.js";
+/**
+ * Format employees as markdown
+ */
+export declare function formatEmployeesMarkdown(employees: Employee[]): string;
+/**
+ * Format a single employee as markdown
+ */
+export declare function formatEmployeeMarkdown(employee: Employee): string;
+/**
+ * Register all employee-related tools
+ */
+export declare function registerEmployeeTools(server: McpServer): void;
+//# sourceMappingURL=employees.d.ts.map

package/dist/tools/team/employees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"employees.d.ts","sourceRoot":"","sources":["../../../src/tools/team/employees.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU1C;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAoBrE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAWjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6F7D"}

package/dist/tools/team/employees.js

@@ -0,0 +1,149 @@
+/**
+ * Employee tools for Holded API
+ */
+import { ListEmployeesInputSchema, GetEmployeeInputSchema, CreateEmployeeInputSchema, UpdateEmployeeInputSchema, DeleteEmployeeInputSchema, } from "../../schemas/team/employees.js";
+import { registerCrudTools } from "../factory.js";
+/**
+ * Format employees as markdown
+ */
+export function formatEmployeesMarkdown(employees) {
+    if (!employees.length) {
+        return "No employees found.";
+    }
+    const lines = ["# Employees", "", `Found ${employees.length} employees:`, ""];
+    for (const employee of employees) {
+        lines.push(`## ${employee.name}`);
+        lines.push(`- **ID**: ${employee.id}`);
+        if (employee.email)
+            lines.push(`- **Email**: ${employee.email}`);
+        if (employee.phone)
+            lines.push(`- **Phone**: ${employee.phone}`);
+        if (employee.position)
+            lines.push(`- **Position**: ${employee.position}`);
+        if (employee.department)
+            lines.push(`- **Department**: ${employee.department}`);
+        if (employee.status)
+            lines.push(`- **Status**: ${employee.status}`);
+        if (employee.hireDate)
+            lines.push(`- **Hire Date**: ${new Date(employee.hireDate * 1000).toLocaleDateString()}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single employee as markdown
+ */
+export function formatEmployeeMarkdown(employee) {
+    const lines = [`# ${employee.name}`, "", `**ID**: ${employee.id}`, ""];
+    if (employee.email)
+        lines.push(`- **Email**: ${employee.email}`);
+    if (employee.phone)
+        lines.push(`- **Phone**: ${employee.phone}`);
+    if (employee.position)
+        lines.push(`- **Position**: ${employee.position}`);
+    if (employee.department)
+        lines.push(`- **Department**: ${employee.department}`);
+    if (employee.status)
+        lines.push(`- **Status**: ${employee.status}`);
+    if (employee.hireDate)
+        lines.push(`- **Hire Date**: ${new Date(employee.hireDate * 1000).toLocaleDateString()}`);
+    return lines.join("\n");
+}
+/**
+ * Register all employee-related tools
+ */
+export function registerEmployeeTools(server) {
+    registerCrudTools(server, {
+        module: "team",
+        toolPrefix: "holded_team",
+        resource: "employee",
+        resourcePlural: "employees",
+        endpoint: "employees",
+        idParam: "employee_id",
+        schemas: {
+            list: ListEmployeesInputSchema,
+            get: GetEmployeeInputSchema,
+            create: CreateEmployeeInputSchema,
+            update: UpdateEmployeeInputSchema,
+            delete: DeleteEmployeeInputSchema,
+        },
+        titles: {
+            list: "List Holded Employees",
+            get: "Get Holded Employee",
+            create: "Create Holded Employee",
+            update: "Update Holded Employee",
+            delete: "Delete Holded Employee",
+        },
+        descriptions: {
+            list: `List 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 employees with id, name, email, position, department, and status.`,
+            get: `Get a specific employee by ID from Holded.
+
+Args:
+  - employee_id (string): The employee ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Employee details including name, email, position, department, and status.`,
+            create: `Create a new employee in Holded.
+
+According to Holded Team API v1.0.1, employee creation supports:
+  - name (string): Employee name (required)
+  - lastName (string): Employee last name (required)
+  - email (string): Email address (required)
+  - sendInvite (boolean): Whether to send invitation email to the employee (optional)
+
+Additional fields like phone, position, department should be set via Update Employee after creation.
+
+Returns:
+  The created employee with its assigned ID.`,
+            update: `Update an existing employee in Holded.
+
+Args:
+  - employee_id (string): The employee ID to update (required)
+  - name (string): Employee name
+  - lastName (string): Employee last name
+  - mainEmail (string): Main email address
+  - email (string): Email address
+  - nationality (string): Nationality
+  - phone (string): Phone number
+  - mobile (string): Mobile phone number
+  - dateOfBirth (string): Date of birth (dd/mm/yyyy)
+  - gender ('male' | 'female'): Gender
+  - mainLanguage (string): Main language
+  - iban (string): Bank IBAN
+  - timeOffPolicyId (string): Time off policy ID
+  - timeOffSupervisors (array): Array of supervisor employee IDs
+  - reportingTo (string): Reporting manager employee ID
+  - code (string): NIF/tax identification number
+  - socialSecurityNum (string): Social security number
+  - address (object): Address object with address, city, postalCode, province, country
+  - fiscalResidence (boolean): Fiscal residence (set to false to use fiscalAddress)
+  - fiscalAddress (object): Fiscal address (requires fiscalResidence to be false)
+  - workplace (string): Workplace ID
+  - teams (array): Array of team IDs
+  - holdedUserId (string): Holded user ID
+
+Returns:
+  Confirmation with status, info, and employee ID.`,
+            delete: `Delete an employee from Holded.
+
+Args:
+  - employee_id (string): The employee ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        },
+        formatters: {
+            list: formatEmployeesMarkdown,
+            single: formatEmployeeMarkdown,
+        },
+    });
+}
+//# sourceMappingURL=employees.js.map

package/dist/tools/team/employees.js.map

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

package/dist/tools/team/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Team module tools registration
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all team-related tools
+ */
+export declare function registerTeamTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/team/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/team/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAGzD"}

package/dist/tools/team/index.js

@@ -0,0 +1,13 @@
+/**
+ * Team module tools registration
+ */
+import { registerEmployeeTools } from "./employees.js";
+import { registerTimeTrackingTools } from "./time-tracking.js";
+/**
+ * Register all team-related tools
+ */
+export function registerTeamTools(server) {
+    registerEmployeeTools(server);
+    registerTimeTrackingTools(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/team/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/team/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/tools/team/time-tracking.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Time Tracking tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TimeTracking } from "../../types.js";
+/**
+ * Format time-trackings as markdown
+ */
+export declare function formatTimeTrackingsMarkdown(times: TimeTracking[]): string;
+/**
+ * Format a single time-tracking as markdown
+ */
+export declare function formatTimeTrackingMarkdown(time: TimeTracking): string;
+/**
+ * Register all time-tracking-related tools
+ */
+export declare function registerTimeTrackingTools(server: McpServer): void;
+//# sourceMappingURL=time-tracking.d.ts.map

package/dist/tools/team/time-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-tracking.d.ts","sourceRoot":"","sources":["../../../src/tools/team/time-tracking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAyB9C;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAoBzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAWrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgdjE"}