@mpurdon/mcp-freshbooks 0.1.0

package/dist/tools/invoice_generator.js

@@ -0,0 +1,235 @@
+/**
+ * generate_invoice tool — fetches FreshBooks time entries for a date range,
+ * groups them by project + service, looks up the billable rate for each
+ * service, and creates a draft invoice for the Trajector client.
+ *
+ * The line-item format exactly matches the Python fb.py script:
+ *   name        → service name (e.g. "Principal Engineer")
+ *   description → "(Project Name) Matthew Purdon – Apr 16, 2026 - Apr 30, 2026"
+ *   qty         → total hours for that service (decimal)
+ *   unit_cost   → billable rate from the FreshBooks project service record
+ *   type        → 0 (item/service)
+ */
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs/promises";
+import { z } from "zod";
+// ── Timesheet path helper ─────────────────────────────────────────────────────
+const OUTPUT_DIR = path.join(os.homedir(), "Documents", "trajector", "timesheets");
+/** Returns the expected timesheet path for a given end_date (end_date + 1 day). */
+function timesheetPathForPeriod(endDate) {
+    const dt = new Date(`${endDate}T12:00:00Z`);
+    dt.setUTCDate(dt.getUTCDate() + 1);
+    const sendDate = dt.toISOString().slice(0, 10);
+    return path.join(OUTPUT_DIR, `Consultant-Bi-Weekly-Timesheet ${sendDate}.xlsx`);
+}
+// ── Constants ─────────────────────────────────────────────────────────────────
+const TRAJECTOR_CLIENT_ID = 688912;
+// ── Input schema ──────────────────────────────────────────────────────────────
+export const GenerateInvoiceInput = z
+    .object({
+    start_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .describe("YYYY-MM-DD — start of billing period"),
+    end_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .describe("YYYY-MM-DD — end of billing period"),
+    invoice_number: z
+        .string()
+        .max(50)
+        .optional()
+        .describe("Override the auto-assigned invoice number"),
+    create_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional()
+        .describe("Invoice date (YYYY-MM-DD). Defaults to today."),
+    due_offset_days: z
+        .number()
+        .int()
+        .min(0)
+        .max(365)
+        .optional()
+        .default(0)
+        .describe("Days after create_date when the invoice is due."),
+    draft: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Create as draft (true) or immediately mark as sent (false)."),
+})
+    .strict();
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/** Format a YYYY-MM-DD date as "Apr 16, 2026" */
+function formatDate(ymd) {
+    const [year, month, day] = ymd.split("-").map(Number);
+    const d = new Date(year, month - 1, day);
+    return d.toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+        year: "numeric",
+    });
+}
+/** Round to 2 decimal places, returning as a number */
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+// ── FreshBooks data layer ─────────────────────────────────────────────────────
+async function fetchProjectsWithRates(client) {
+    const data = await client.request("GET", `/projects/business/${client.businessId}/projects`, {
+        query: { active: "true", client_id: TRAJECTOR_CLIENT_ID },
+    });
+    const map = new Map();
+    for (const p of data.projects ?? []) {
+        const svcMap = new Map();
+        for (const s of p.services ?? []) {
+            const rawRate = s.rate ?? s.unit_cost ?? s.hourly_rate ?? s.price ?? null;
+            const rate = rawRate !== null ? Number(rawRate) : null;
+            svcMap.set(s.id, {
+                name: s.name,
+                rate: Number.isFinite(rate) ? rate : null,
+            });
+        }
+        map.set(p.id, { title: p.title, services: svcMap });
+    }
+    return map;
+}
+async function fetchTimeEntries(client, startDate, endDate) {
+    const data = await client.request("GET", `/timetracking/business/${client.businessId}/time_entries`, {
+        query: {
+            client_id: TRAJECTOR_CLIENT_ID,
+            started_from: `${startDate}T00:00:00Z`,
+            started_to: `${endDate}T23:59:59Z`,
+            per_page: 100,
+        },
+    });
+    return (data.time_entries ?? [])
+        .filter((e) => e.active !== false)
+        .map((e) => ({
+        projectId: e.project_id,
+        serviceId: e.service_id,
+        duration: e.duration,
+    }));
+}
+// ── Core logic ────────────────────────────────────────────────────────────────
+function groupEntries(entries, projects) {
+    const groups = new Map();
+    for (const e of entries) {
+        const project = projects.get(e.projectId);
+        const projectTitle = project?.title ?? `Project ${e.projectId}`;
+        const service = project?.services.get(e.serviceId);
+        const serviceName = service?.name ?? `Service ${e.serviceId}`;
+        const key = `${e.projectId}::${e.serviceId}`;
+        const existing = groups.get(key);
+        if (existing) {
+            existing.totalSeconds += e.duration;
+        }
+        else {
+            groups.set(key, {
+                projectTitle,
+                serviceName,
+                serviceId: e.serviceId,
+                totalSeconds: e.duration,
+            });
+        }
+    }
+    return Array.from(groups.values());
+}
+// ── Main handler ──────────────────────────────────────────────────────────────
+export async function generateInvoice(client, input) {
+    const [projects, rawEntries] = await Promise.all([
+        fetchProjectsWithRates(client),
+        fetchTimeEntries(client, input.start_date, input.end_date),
+    ]);
+    if (rawEntries.length === 0) {
+        throw new Error(`No time entries found for ${input.start_date} – ${input.end_date} (client ${TRAJECTOR_CLIENT_ID}).`);
+    }
+    const groups = groupEntries(rawEntries, projects);
+    const warnings = [];
+    // Build line items
+    const startLabel = formatDate(input.start_date);
+    const endLabel = formatDate(input.end_date);
+    const lines = groups.map((g) => {
+        const project = projects.get([...projects.entries()].find(([, p]) => p.title === g.projectTitle)?.[0] ?? -1);
+        const rate = project?.services.get(g.serviceId)?.rate ?? null;
+        const hours = round2(g.totalSeconds / 3600);
+        if (rate === null) {
+            warnings.push(`No rate found for service "${g.serviceName}" (id ${g.serviceId}) in project "${g.projectTitle}". Line item will have unit_cost of 0.`);
+        }
+        return {
+            name: g.serviceName,
+            description: `(${g.projectTitle}) Matthew Purdon – ${startLabel} - ${endLabel}`,
+            qty: String(hours),
+            unit_cost: { amount: rate !== null ? String(rate) : "0", code: "USD" },
+            type: 0,
+        };
+    });
+    // Invoice notes (top-level description) mirrors the Python script
+    const projectTitle = groups[0]?.projectTitle ?? "Unknown Project";
+    const notes = `(${projectTitle}) Matthew Purdon – ${startLabel} - ${endLabel}`;
+    const invoicePayload = {
+        customerid: TRAJECTOR_CLIENT_ID,
+        notes,
+        lines,
+        status: 1, // draft
+    };
+    if (input.create_date)
+        invoicePayload.create_date = input.create_date;
+    if (input.due_offset_days !== undefined)
+        invoicePayload.due_offset_days = input.due_offset_days;
+    if (input.invoice_number)
+        invoicePayload.invoice_number = input.invoice_number;
+    const path = `/accounting/account/${client.accountId}/invoices/invoices`;
+    const created = await client.accounting("POST", path, "invoice", {
+        body: { invoice: invoicePayload },
+    });
+    const invoiceId = created.invoiceid ?? created.id ?? 0;
+    const invoiceNumber = created.invoice_number ?? "";
+    const totalAmount = created.amount?.amount ?? "0";
+    const currency = created.amount?.code ?? "USD";
+    // Summarize line items for the return value
+    const lineItemSummary = groups.map((g) => {
+        const project = projects.get([...projects.entries()].find(([, p]) => p.title === g.projectTitle)?.[0] ?? -1);
+        const rate = project?.services.get(g.serviceId)?.rate ?? null;
+        const hours = round2(g.totalSeconds / 3600);
+        return {
+            service: g.serviceName,
+            project: g.projectTitle,
+            hours,
+            rate,
+            amount: rate !== null ? round2(hours * rate) : null,
+        };
+    });
+    // ── Attach timesheet if it exists ─────────────────────────────────────────
+    let timesheetAttached = false;
+    let timesheetPath = null;
+    if (invoiceId) {
+        const expectedPath = timesheetPathForPeriod(input.end_date);
+        try {
+            await fs.access(expectedPath);
+            // File exists — attach it
+            timesheetPath = expectedPath;
+            await client.attachFileToInvoice(invoiceId, expectedPath);
+            timesheetAttached = true;
+        }
+        catch {
+            // File doesn't exist (generate_timesheet hasn't been run yet, or different path)
+            timesheetPath = null;
+            warnings.push(`Timesheet not attached: no file found at ${expectedPath}. ` +
+                "Run generate_timesheet first, then the attachment will be added automatically.");
+        }
+    }
+    return {
+        invoiceId,
+        invoiceNumber,
+        totalAmount,
+        currency,
+        lineItems: lineItemSummary,
+        timesheetAttached,
+        timesheetPath,
+        warnings,
+    };
+}
+//# sourceMappingURL=invoice_generator.js.map

package/dist/tools/invoice_generator.js.map

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

package/dist/tools/invoices.js

@@ -0,0 +1,247 @@
+/**
+ * Invoice tools: list, get, create, update, send, delete.
+ *
+ * FreshBooks invoice status mapping (v3_status):
+ *   draft, created, sent, viewed, partial, paid, auto-paid, retry,
+ *   failed, declined, overdue, disputed, resolved
+ *
+ * Money on invoice creation uses the { amount: "12.50", code: "USD" } shape
+ * for `unit_cost`. Read-side amount fields use the same shape.
+ *
+ * Delete is a soft delete: PUT with { invoice: { vis_state: 1 } }. We
+ * expose this via delete_invoice and document it in the README.
+ */
+import { z } from "zod";
+// ---------- Schemas ----------
+const InvoiceStatusEnum = z.enum([
+    "draft",
+    "created",
+    "sent",
+    "viewed",
+    "partial",
+    "paid",
+    "auto-paid",
+    "retry",
+    "failed",
+    "declined",
+    "overdue",
+    "disputed",
+    "resolved",
+]);
+export const ListInvoicesInput = z
+    .object({
+    status: InvoiceStatusEnum.optional().describe("Filter by v3_status."),
+    client_id: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("FreshBooks client (userid)."),
+    date_from: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional()
+        .describe("YYYY-MM-DD."),
+    date_to: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional()
+        .describe("YYYY-MM-DD."),
+    search: z
+        .string()
+        .max(200)
+        .optional()
+        .describe("Match invoice number or notes."),
+    page: z.number().int().min(1).default(1),
+    per_page: z.number().int().min(1).max(100).default(20),
+})
+    .strict();
+export const GetInvoiceInput = z
+    .object({
+    invoice_id: z.number().int().positive(),
+})
+    .strict();
+const LineItemInput = z
+    .object({
+    description: z.string().min(1).max(10_000),
+    qty: z.number().positive(),
+    unit_cost: z
+        .number()
+        .nonnegative()
+        .describe("Per-unit price as a decimal, e.g. 75.00."),
+    name: z.string().max(200).optional(),
+    taxName1: z.string().max(50).optional(),
+    taxAmount1: z
+        .number()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe("Percent, e.g. 13."),
+})
+    .strict();
+export const CreateInvoiceInput = z
+    .object({
+    client_id: z
+        .number()
+        .int()
+        .positive()
+        .describe("FreshBooks userid of the client."),
+    lines: z.array(LineItemInput).min(1).max(100),
+    currency_code: z.string().length(3).default("USD"),
+    due_offset_days: z.number().int().min(0).max(365).optional(),
+    notes: z.string().max(10_000).optional(),
+    terms: z.string().max(10_000).optional(),
+    invoice_number: z.string().max(50).optional(),
+    create_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional(),
+})
+    .strict();
+export const UpdateInvoiceInput = z
+    .object({
+    invoice_id: z.number().int().positive(),
+    notes: z.string().max(10_000).optional(),
+    terms: z.string().max(10_000).optional(),
+    due_offset_days: z.number().int().min(0).max(365).optional(),
+    invoice_number: z.string().max(50).optional(),
+    lines: z
+        .array(LineItemInput)
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("If provided, REPLACES all line items."),
+})
+    .strict();
+export const SendInvoiceInput = z
+    .object({
+    invoice_id: z.number().int().positive(),
+    recipients: z
+        .array(z.string().email())
+        .max(10)
+        .optional()
+        .describe("Override recipients. Defaults to client's email on file."),
+    subject: z.string().max(200).optional(),
+    body: z.string().max(10_000).optional(),
+})
+    .strict();
+export const DeleteInvoiceInput = z
+    .object({
+    invoice_id: z.number().int().positive(),
+})
+    .strict();
+// ---------- Handlers ----------
+export async function listInvoices(client, input) {
+    const path = `/accounting/account/${client.accountId}/invoices/invoices`;
+    const query = {
+        page: input.page,
+        per_page: input.per_page,
+    };
+    if (input.status)
+        query["search[v3_status]"] = input.status;
+    if (input.client_id)
+        query["search[customerid]"] = input.client_id;
+    if (input.date_from)
+        query["search[date_min]"] = input.date_from;
+    if (input.date_to)
+        query["search[date_max]"] = input.date_to;
+    if (input.search)
+        query["search[invoice_number_like]"] = input.search;
+    const result = await client.accounting("GET", path, "", { query });
+    // accounting<T> returns env.response.result[key]; for list we want the whole result.
+    // Use a different unwrap path: pull the whole result object.
+    return summarizeListResult(result);
+}
+// listInvoices/listClients/listItems all share the same envelope shape.
+// `accounting` extracts result[key]; for lists we want the result object itself,
+// so use a custom unwrap helper here.
+function summarizeListResult(result) {
+    return result;
+}
+export async function getInvoice(client, input) {
+    const path = `/accounting/account/${client.accountId}/invoices/invoices/${input.invoice_id}`;
+    return client.accounting("GET", path, "invoice", {
+        query: { "include[]": "lines" },
+    });
+}
+export async function createInvoice(client, input) {
+    const path = `/accounting/account/${client.accountId}/invoices/invoices`;
+    const body = {
+        invoice: {
+            customerid: input.client_id,
+            currency_code: input.currency_code,
+            create_date: input.create_date,
+            due_offset_days: input.due_offset_days,
+            invoice_number: input.invoice_number,
+            notes: input.notes,
+            terms: input.terms,
+            lines: input.lines.map((l) => ({
+                type: 0,
+                name: l.name,
+                description: l.description,
+                qty: String(l.qty),
+                unit_cost: {
+                    amount: l.unit_cost.toFixed(2),
+                    code: input.currency_code,
+                },
+                ...(l.taxName1 ? { taxName1: l.taxName1 } : {}),
+                ...(l.taxAmount1 !== undefined
+                    ? { taxAmount1: String(l.taxAmount1) }
+                    : {}),
+            })),
+        },
+    };
+    return client.accounting("POST", path, "invoice", { body });
+}
+export async function updateInvoice(client, input) {
+    const path = `/accounting/account/${client.accountId}/invoices/invoices/${input.invoice_id}`;
+    const invoice = {};
+    if (input.notes !== undefined)
+        invoice.notes = input.notes;
+    if (input.terms !== undefined)
+        invoice.terms = input.terms;
+    if (input.due_offset_days !== undefined)
+        invoice.due_offset_days = input.due_offset_days;
+    if (input.invoice_number !== undefined)
+        invoice.invoice_number = input.invoice_number;
+    if (input.lines) {
+        invoice.lines = input.lines.map((l) => ({
+            type: 0,
+            name: l.name,
+            description: l.description,
+            qty: String(l.qty),
+            unit_cost: { amount: l.unit_cost.toFixed(2), code: "USD" },
+            ...(l.taxName1 ? { taxName1: l.taxName1 } : {}),
+            ...(l.taxAmount1 !== undefined
+                ? { taxAmount1: String(l.taxAmount1) }
+                : {}),
+        }));
+    }
+    return client.accounting("PUT", path, "invoice", {
+        body: { invoice },
+    });
+}
+export async function sendInvoice(client, input) {
+    const path = `/accounting/account/${client.accountId}/invoices/invoices/${input.invoice_id}`;
+    const invoice = { action_email: true };
+    if (input.recipients && input.recipients.length > 0) {
+        invoice.email_recipients = input.recipients;
+    }
+    if (input.subject)
+        invoice.email_subject = input.subject;
+    if (input.body)
+        invoice.email_body = input.body;
+    return client.accounting("PUT", path, "invoice", {
+        body: { invoice },
+    });
+}
+/**
+ * FreshBooks soft-deletes invoices: vis_state=1 (deleted), 2 (archived), 0 (active).
+ */
+export async function deleteInvoice(client, input) {
+    const path = `/accounting/account/${client.accountId}/invoices/invoices/${input.invoice_id}`;
+    return client.accounting("PUT", path, "invoice", {
+        body: { invoice: { vis_state: 1 } },
+    });
+}
+//# sourceMappingURL=invoices.js.map

package/dist/tools/invoices.js.map

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

package/dist/tools/items.js

@@ -0,0 +1,24 @@
+/**
+ * Item tools: list_items.
+ *
+ * Endpoint: /accounting/account/<account_id>/items/items
+ */
+import { z } from "zod";
+export const ListItemsInput = z
+    .object({
+    search: z.string().max(200).optional().describe("Match item name."),
+    page: z.number().int().min(1).default(1),
+    per_page: z.number().int().min(1).max(100).default(20),
+})
+    .strict();
+export async function listItems(client, input) {
+    const path = `/accounting/account/${client.accountId}/items/items`;
+    const query = {
+        page: input.page,
+        per_page: input.per_page,
+    };
+    if (input.search)
+        query["search[name_like]"] = input.search;
+    return client.accounting("GET", path, "", { query });
+}
+//# sourceMappingURL=items.js.map

package/dist/tools/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/tools/items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAwB,EACxB,KAAqC;IAErC,MAAM,IAAI,GAAG,uBAAuB,MAAM,CAAC,SAAS,cAAc,CAAC;IACnE,MAAM,KAAK,GAAoC;QAC7C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;IACF,IAAI,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAS5D,OAAO,MAAM,CAAC,UAAU,CAAS,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC"}