feat: list tools for invoices, journals, payments and quotes

Author: john-zhang-dev

src/Tools/Invoices.ts

@@ -0,0 +1,27 @@
+import { XeroClientSession } from "../XeroApiClient.js";
+import { IMcpServerTool } from "./IMcpServerTool.js";
+import { z } from "zod";
+
+export const ListInvoicesTool: IMcpServerTool = {
+  requestSchema: {
+    name: "list_invoices",
+    description: "List all invoices",
+    inputSchema: { type: "object", properties: {} },
+    output: { content: [{ type: "text", text: z.string() }] },
+  },
+  requestHandler: async () => {
+    const response =
+      await XeroClientSession.xeroClient.accountingApi.getInvoices(
+        XeroClientSession.activeTenantId()!!
+      );
+    const invoices = response.body.invoices || [];
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(invoices),
+        },
+      ],
+    };
+  },
+};

src/Tools/Journals.ts

@@ -0,0 +1,27 @@
+import { XeroClientSession } from "../XeroApiClient.js";
+import { IMcpServerTool } from "./IMcpServerTool.js";
+import { z } from "zod";
+
+export const ListJournalsTool: IMcpServerTool = {
+  requestSchema: {
+    name: "list_journals",
+    description: "List all journals",
+    inputSchema: { type: "object", properties: {} },
+    output: { content: [{ type: "text", text: z.string() }] },
+  },
+  requestHandler: async () => {
+    const response =
+      await XeroClientSession.xeroClient.accountingApi.getJournals(
+        XeroClientSession.activeTenantId()!!
+      );
+    const journals = response.body.journals || [];
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(journals),
+        },
+      ],
+    };
+  },
+};

src/Tools/McpToolsFactory.ts

@@ -3,15 +3,23 @@ import { AuthenticateTool } from "./Authenticate.js";
 import { ListBankTransactionsTool } from "./BankTransactions.js";
 import { ListContactsTool } from "./Contacts.js";
 import { IMcpServerTool } from "./IMcpServerTool.js";
+import { ListInvoicesTool } from "./Invoices.js";
+import { ListJournalsTool } from "./Journals.js";
 import { ListOrganisationsTool } from "./Organisations.js";
+import { ListPaymentsTool } from "./Payments.js";
+import { ListQuotesTool } from "./Quotes.js";
 
 export const McpToolsFactory = (function () {
   const tools: IMcpServerTool[] = [
     AuthenticateTool,
     ListAccountsTool,
     ListBankTransactionsTool,
     ListContactsTool,
+    ListInvoicesTool,
+    ListJournalsTool,
     ListOrganisationsTool,
+    ListPaymentsTool,
+    ListQuotesTool,
     // register new tools here alphabetically
   ];
 

src/Tools/Payments.ts

@@ -0,0 +1,27 @@
+import { XeroClientSession } from "../XeroApiClient.js";
+import { IMcpServerTool } from "./IMcpServerTool.js";
+import { z } from "zod";
+
+export const ListPaymentsTool: IMcpServerTool = {
+  requestSchema: {
+    name: "list_payments",
+    description: "List all payments",
+    inputSchema: { type: "object", properties: {} },
+    output: { content: [{ type: "text", text: z.string() }] },
+  },
+  requestHandler: async () => {
+    const response =
+      await XeroClientSession.xeroClient.accountingApi.getPayments(
+        XeroClientSession.activeTenantId()!!
+      );
+    const payments = response.body.payments || [];
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(payments),
+        },
+      ],
+    };
+  },
+};

src/Tools/Quotes.ts

@@ -0,0 +1,26 @@
+import { XeroClientSession } from "../XeroApiClient.js";
+import { IMcpServerTool } from "./IMcpServerTool.js";
+import { z } from "zod";
+
+export const ListQuotesTool: IMcpServerTool = {
+  requestSchema: {
+    name: "list_quotes",
+    description: "List all quotes",
+    inputSchema: { type: "object", properties: {} },
+    output: { content: [{ type: "text", text: z.string() }] },
+  },
+  requestHandler: async () => {
+    const response = await XeroClientSession.xeroClient.accountingApi.getQuotes(
+      XeroClientSession.activeTenantId()!!
+    );
+    const quotes = response.body.quotes || [];
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(quotes),
+        },
+      ],
+    };
+  },
+};

src/XeroApiClient.ts

@@ -5,7 +5,7 @@ const client_id = process.env.XERO_CLIENT_ID;
 const client_secret = process.env.XERO_CLIENT_SECRET;
 const redirectUrl = process.env.XERO_REDIRECT_URI;
 const scopes =
-  "offline_access openid profile email accounting.transactions accounting.budgets.read accounting.reports.read accounting.journals.read accounting.settings accounting.settings.read accounting.contacts accounting.contacts.read accounting.attachments accounting.attachments.read files files.read assets assets.read projects projects.read";
+  "offline_access openid profile accounting.transactions accounting.contacts.read accounting.journals.read";
 
 if (!client_id || !client_secret || !redirectUrl) {
   throw Error(