Skip to main content
Glama

Xero MCP Server

Official
MIT License
743
110
  • Apple
  • Linux

Servidor MCP de Xero

Esta es una implementación de servidor del Protocolo de Contexto de Modelo (MCP) para Xero. Proporciona un puente entre el protocolo MCP y la API de Xero, lo que permite un acceso estandarizado a las funciones de contabilidad y empresariales de Xero.

Características

  • Autenticación OAuth2 de Xero con conexiones personalizadas
  • Gestión de contactos
  • Gestión del plan de cuentas
  • Creación y gestión de facturas
  • Cumplimiento del protocolo MCP

Prerrequisitos

  • Node.js (v18 o superior)
  • npm o pnpm
  • Una cuenta de desarrollador de Xero con credenciales de API

Documentos y enlaces

Configuración

Crear una cuenta de Xero

Si aún no tiene una cuenta y una organización de Xero, puede crear una registrándose aquí usando la prueba gratuita.

Recomendamos usar una empresa de demostración para empezar, ya que incluye datos de muestra precargados. Una vez iniciada la sesión, acceda a ella mediante el menú desplegable superior izquierdo y seleccione "Empresa de demostración". Puede restablecer los datos de una empresa de demostración o cambiar el país en cualquier momento mediante el menú desplegable superior izquierdo y accediendo a Mi Xero .

NOTA: Para utilizar consultas específicas de nómina, la región debe ser Nueva Zelanda o Reino Unido.

Autenticación

Hay 2 modos de autenticación admitidos en el servidor Xero MCP:

1. Conexiones personalizadas

Esta es una mejor opción para pruebas y desarrollo, ya que permite especificar el ID de cliente y los secretos para una organización específica. También es el enfoque recomendado si se integra con clientes MCP de terceros, como Claude Desktop.

Configuración de su cuenta de desarrollador de Xero

Configure una conexión personalizada siguiendo estas instrucciones: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

Actualmente se requieren los siguientes ámbitos para todas las sesiones: ámbitos

Integración del servidor MCP con Claude Desktop

Para agregar el servidor MCP a Claude, vaya a Configuración > Desarrollador > Editar configuración y agregue lo siguiente a su archivo claude_desktop_config.json:

{ "mcpServers": { "xero": { "command": "npx", "args": ["-y", "@xeroapi/xero-mcp-server@latest"], "env": { "XERO_CLIENT_ID": "your_client_id_here", "XERO_CLIENT_SECRET": "your_client_secret_here" } } } }

NOTA: Si está utilizando la sección "command": "npx" de Node Version Manager, cámbiela para que sea la ruta completa al ejecutable, es decir: your_home_directory/.nvm/versions/node/v22.14.0/bin/npx en Mac/Linux o "your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx" en Windows

2. Token al portador

Esta es una mejor opción si desea admitir varias cuentas de Xero en tiempo de ejecución y permitir que el cliente MCP ejecute un flujo de autenticación (como PKCE) según sea necesario. En este caso, utilice la siguiente configuración:

{ "mcpServers": { "xero": { "command": "npx", "args": ["-y", "@xeroapi/xero-mcp-server@latest"], "env": { "XERO_CLIENT_BEARER_TOKEN": "your_bearer_token" } } } }

NOTA: XERO_CLIENT_BEARER_TOKEN tendrá prioridad sobre XERO_CLIENT_ID si está definido.

Comandos MCP disponibles

  • list-accounts : Recuperar una lista de cuentas
  • list-contacts : recupera una lista de contactos de Xero
  • list-credit-notes : Recuperar una lista de notas de crédito
  • list-invoices : Recuperar una lista de facturas
  • list-items : recupera una lista de elementos
  • list-organisation-details : recupera detalles sobre una organización
  • list-profit-and-loss : Recuperar un informe de ganancias y pérdidas
  • list-quotes : Recuperar una lista de citas
  • list-tax-rates : recupera una lista de tasas impositivas
  • list-payments : recupera una lista de pagos
  • list-trial-balance : Recuperar un informe de balance de comprobación
  • list-profit-and-loss : Recuperar un informe de ganancias y pérdidas
  • list-bank-transactions : recupera una lista de transacciones de cuentas bancarias
  • list-payroll-employees : Recuperar una lista de empleados de nómina
  • list-report-balance-sheet : Recuperar un informe de balance general
  • list-payroll-employee-leave : recupera los registros de licencia de un empleado de nómina
  • list-payroll-employee-leave-balances : Recuperar los saldos de licencias de un empleado de nómina
  • list-payroll-employee-leave-types : recupera una lista de tipos de licencia de nómina
  • list-payroll-leave-periods : recupera una lista de los períodos de licencia de un empleado de nómina
  • list-payroll-leave-types : recupera una lista de todos los tipos de licencia disponibles en Xero Payroll
  • list-aged-receivables-by-contact : recupera cuentas por cobrar vencidas de un contacto
  • list-aged-payables-by-contact : recupera las cuentas por pagar vencidas de un contacto
  • list-contact-groups : recupera una lista de grupos de contactos
  • create-contact : Crea un nuevo contacto
  • create-credit-note : Crea una nueva nota de crédito
  • create-invoice : Crea una nueva factura
  • create-payment : Crea un nuevo pago
  • create-quote : Crea una nueva cotización
  • create-credit-note : Crea una nueva nota de crédito
  • create-payroll-timesheet : Crea una nueva hoja de horas de nómina
  • update-contact : Actualizar un contacto existente
  • update-invoice : Actualizar un borrador de factura existente
  • update-quote : Actualizar un borrador de cotización existente
  • update-credit-note : Actualizar un borrador de nota de crédito existente
  • update-payroll-timesheet-line : Actualizar una línea en una hoja de horas de nómina existente
  • approve-payroll-timesheet : Aprobar una planilla de nómina
  • revert-payroll-timesheet : Revertir una hoja de horas de nómina aprobada
  • add-payroll-timesheet-line : Agregar nueva línea en una hoja de horas de nómina existente
  • delete-payroll-timesheet : Eliminar una hoja de horas de nómina existente
  • get-payroll-timesheet : Recuperar una hoja de horas de nómina existente

Para obtener documentación detallada de la API, consulte la Especificación del protocolo MCP .

Para desarrolladores

Instalación

# Using npm npm install # Using pnpm pnpm install

Ejecutar una compilación

# Using npm npm run build # Using pnpm pnpm build

Integración con Claude Desktop

Para vincular su servidor Xero MCP en desarrollo a Claude Desktop, vaya a Configuración > Desarrollador > Editar configuración y agregue lo siguiente a su archivo claude_desktop_config.json :

NOTA: Para Windows, asegúrese de que la ruta args escape el \ entre carpetas, por ejemplo, "C:\\projects\xero-mcp-server\\dist\\index.js"

{ "mcpServers": { "xero": { "command": "node", "args": ["insert-your-file-path-here/xero-mcp-server/dist/index.js"], "env": { "XERO_CLIENT_ID": "your_client_id_here", "XERO_CLIENT_SECRET": "your_client_secret_here" } } } }

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Seguridad

No envíe su archivo .env ni ninguna credencial confidencial al control de versiones (está incluido en .gitignore como un valor predeterminado seguro).

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Una implementación de servidor de Protocolo de Contexto de Modelo que proporciona acceso estandarizado a las funciones comerciales y contables de Xero, lo que permite operaciones como administración de contactos, creación de facturas y administración de planes de cuentas a través de MCP.

  1. Características
    1. Prerrequisitos
      1. Documentos y enlaces
        1. Configuración
          1. Crear una cuenta de Xero
          2. Autenticación
          3. Comandos MCP disponibles
        2. Para desarrolladores
          1. Instalación
          2. Ejecutar una compilación
          3. Integración con Claude Desktop
        3. Licencia
          1. Seguridad

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              Enables interaction with the Xano API through a Model Context Protocol (MCP) interface, providing secure and type-safe management of Xano database operations.
              Last updated -
              6
              TypeScript
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that facilitates communication between ABAP systems and MCP clients, providing tools for managing ABAP objects, handling transport requests, and performing code analysis to enhance ABAP development workflows.
              Last updated -
              128
              40
              TypeScript
              MIT License
              • Linux
              • Apple
            • -
              security
              A
              license
              -
              quality
              An MCP server allowing Clients to interact with Xero Accounting Software
              Last updated -
              672
              17
              TypeScript
              MIT License
              • Apple
            • A
              security
              F
              license
              A
              quality
              A Model Context Protocol server for interacting with the Marketo API that provides tools for managing Marketo forms, including listing, cloning, and approving forms.
              Last updated -
              4
              2
              TypeScript

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/XeroAPI/xero-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server