xero-mcp/build/Tools/Accounting/Contacts.js

A Model Context Protocol server allows Clients to interact with Xero

import { XeroClientSession } from "../../XeroApiClient.js";
import { XeroAccountingApiSchema } from "../../Resources/xero_accounting.js";
import { parseArrayValues } from "../../Utils/parseArrayValues.js";
import { convertToCamelCase } from "../../Utils/convertToCamelCase.js";
import { sanitizeObject } from "../../Utils/sanitizeValues.js";
export const ListContactsTool = {
    requestSchema: {
        name: "list_contacts",
        description: "Retrieves all contacts in a Xero organisation",
        inputSchema: {
            type: "object",
            properties: {
                where: {
                    type: "string",
                    description: "Filter by any element",
                    example: 'ContactStatus=="ACTIVE"',
                },
                order: {
                    type: "string",
                    description: "Order by any element",
                    example: "Name ASC",
                },
                page: {
                    type: "integer",
                    description: "Up to 100 contacts will be returned in a single API call",
                    example: 1,
                },
                includeArchived: {
                    type: "boolean",
                    description: "Contacts with a status of ARCHIVED will be included in the response",
                    example: true,
                },
                searchTerm: {
                    type: "string",
                    description: "Case-insensitive text search across Name, FirstName, LastName, ContactNumber and EmailAddress",
                    example: "Joe Bloggs",
                },
            },
        },
    },
    requestHandler: async (request) => {
        const where = request.params.arguments?.where;
        const order = request.params.arguments?.order;
        const page = request.params.arguments?.page;
        const includeArchived = request.params.arguments?.includeArchived;
        const searchTerm = request.params.arguments?.searchTerm;
        const response = await XeroClientSession.xeroClient.accountingApi.getContacts(XeroClientSession.activeTenantId(), undefined, where, order, undefined, page, includeArchived, undefined, searchTerm);
        const contacts = response.body.contacts || [];
        return {
            content: [
                {
                    type: "text",
                    text: JSON.stringify(contacts),
                },
            ],
        };
    },
};
export const CreateContactsTool = {
    requestSchema: {
        name: "create_contacts",
        description: "Creates one or multiple contacts in a Xero organisation. Only use this tool when user has directly and explicitly ask you to create contact.",
        inputSchema: {
            type: "object",
            description: "Contacts with an array of Contact objects to create",
            properties: XeroAccountingApiSchema.components.schemas.Contacts.properties,
            example: '{ contacts: [{ name: "John Doe" }]}',
        },
    },
    requestHandler: async (request) => {
        const rawInputData = request.params.arguments;
        const parsedData = parseArrayValues(rawInputData);
        const contacts = convertToCamelCase(parsedData);
        const response = await XeroClientSession.xeroClient.accountingApi.createContacts(XeroClientSession.activeTenantId(), sanitizeObject(contacts));
        return { content: [{ type: "text", text: JSON.stringify(response.body) }] };
    },
};