Каталог MCP

XeroAPI/xero-mcp-server

MCP-сервер для интеграции с Xero: управление контактами, счетами, планом счетов, отчётами и расчётами зарплаты через единый протокол. Полезен разработчикам и бухгалтерам, автоматизирующим обмен дан...

README

51 инструмент

Версии

Установить сервер

Xero MCP Server

This is a Model Context Protocol (MCP) server implementation for Xero. It provides a bridge between the MCP protocol and Xero's API, allowing for standardized access to Xero's accounting and business features.

Features

Xero OAuth2 authentication with custom connections
Contact management
Chart of Accounts management
Invoice creation and management
MCP protocol compliance

Prerequisites

Node.js (v18 or higher)
npm or pnpm
A Xero developer account with API credentials

Docs and Links

Setup

Create a Xero Account

If you don't already have a Xero account and organisation already, can create one by signing up here using the free trial.

We recommend using a Demo Company to start with because it comes with some pre-loaded sample data. Once you are logged in, switch to it by using the top left-hand dropdown and selecting "Demo Company". You can reset the data on a Demo Company, or change the country, at any time by using the top left-hand dropdown and navigating to My Xero.

Инструменты были проиндексированы: 05.09.2026

add-timesheet-line

Добавляет новую строку табеля в существующий табель учёта рабочего времени в Xero.

Параметры

timesheetIDstringобязательный
The ID of the timesheet to update.
timesheetLineobjectобязательный
The details of the timesheet line to add.

approve-timesheet

Утверждает табель учёта рабочего времени для расчёта зарплаты в Xero по его идентификатору.

Параметры

timesheetIDstringобязательный
The ID of the timesheet to approve.

create-bank-transaction

Создаёт банковскую транзакцию в Xero. Когда банковская транзакция создана, возвращается глубокая ссылка на неё в Xero. Эта глубокая ссылка позволяет просмотреть банковскую транзакцию прямо в Xero. Ссылку следует отображать пользователю.

Параметры

bankAccountIdstringобязательный
contactIdstringобязательный
datestring
If no date is provided, the date will default to today's date
lineItemsobject[]обязательный
referencestring
typeenumобязательный

create-contact

Создаёт контакт в Xero. После создания контакта возвращается глубокая ссылка на контакт в Xero. По этой ссылке можно открыть контакт напрямую в Xero. Ссылку нужно показать пользователю.

Параметры

emailstring
namestringобязательный
phonestring

create-credit-note

Создаёт кредит-ноту в Xero. После создания возвращается глубокая ссылка на эту кредит-ноту в Xero. По ней можно сразу открыть кредит-ноту в Xero. Эту ссылку нужно показать пользователю.

Параметры

contactIdstringобязательный
lineItemsobject[]обязательный
referencestring

create-invoice

Создаёт счёт в Xero. Когда счёт создан, возвращается глубокая ссылка на счёт в Xero. Эту глубокую ссылку можно использовать для просмотра счёта напрямую в Xero. Эту ссылку следует показать пользователю.

Параметры

contactIdstringобязательный
The ID of the contact to create the invoice for. Can be obtained from the list-contacts tool.
datestring
The date the invoice was created (YYYY-MM-DD format).
lineItemsobject[]обязательный
referencestring
A reference number for the invoice.
typeenumобязательный
The type of invoice to create. ACCREC is for sales invoices, Accounts Receivable, or customer invoices. ACCPAY is for purchase invoices, Accounts Payable invoices, supplier invoices, or bills. If the type is not specified, the default is ACCREC.

create-item

Создаёт элемент в Xero.

Параметры

codestringобязательный
descriptionstring
inventoryAssetAccountCodestring
isTrackedAsInventoryboolean
namestringобязательный
purchaseDescriptionstring
purchaseDetailsobject
salesDetailsobject

create-manual-journal

Создаёт ручной журнал в Xero. Получает список кодов счетов в Xero для использования в строках журнала. Строки журнала должны содержать как минимум две отдельные строки с кодами счетов, использовать основные типы бухгалтерских счетов, если не указано иное, и обеспечивать балансировку пар строк по кредиту и дебету.

Параметры

datestring
Optional date in YYYY-MM-DD format
lineAmountTypesenum
Optional line amount types (EXCLUSIVE, INCLUSIVE, NO_TAX), NO_TAX by default
manualJournalLinesobject[]обязательный
The manualJournalLines element must contain at least two individual manualJournalLine sub-elements
narrationstringобязательный
Description of manual journal being posted
showOnCashBasisReportsboolean
Optional boolean to show on cash basis reports, default is true
statusenum
Optional status of the manual journal (DRAFT, POSTED, DELETED, VOIDED, ARCHIVED), DRAFT by default
urlstring
Optional URL link to a source document

create-payment

Создает платеж по счету в Xero. Этот инструмент регистрирует платежную транзакцию по счету. Вам потребуется указать идентификатор счета (invoice ID), идентификатор счета (account ID), с которого производится платеж, и сумму. Сумма должна быть положительной и не превышать остаток задолженности по счету. Платеж можно создать только для счета со статусом AUTHORIZED. Платеж можно создать только для счета, который оплачен не полностью. При создании платежа возвращается глубокая ссылка на платеж в Xero. Эта глубокая ссылка позволяет просмотреть платеж напрямую в Xero. Эту ссылку необходимо показать пользователю.

Параметры

accountIdstringобязательный
The ID of the account the payment is made from
amountnumberобязательный
The amount of the payment (must be positive)
datestring
Optional payment date in YYYY-MM-DD format
invoiceIdstringобязательный
The ID of the invoice to pay
referencestring
Optional payment reference/description

create-quote

Создаёт предложение в Xero. Когда предложение создано, возвращается глубокая ссылка на это предложение в Xero. Эту глубокую ссылку можно использовать для просмотра предложения непосредственно в Xero. Она должна отображаться пользователю.

Параметры

contactIdstringобязательный
lineItemsobject[]обязательный
quoteNumberstring
referencestring
summarystring
termsstring
titlestring

create-timesheet

Создать новый табель учета рабочего времени в Xero. Это позволяет указать такие детали, как идентификатор сотрудника, идентификатор расчетного календаря, даты начала и окончания, а также строки табеля.

Параметры

employeeIDstringобязательный
The ID of the employee.
endDatestringобязательный
The end date of the timesheet period (YYYY-MM-DD).
payrollCalendarIDstringобязательный
The ID of the payroll calendar.
startDatestringобязательный
The start date of the timesheet period (YYYY-MM-DD).
timesheetLinesobject[]
The lines of the timesheet.

create-tracking-category

Создаёт категорию отслеживания в Xero.

Параметры

namestringобязательный

create-tracking-options

Создаёт варианты отслеживания для категории отслеживания в Xero.

Параметры

optionNamesstring[]обязательный
trackingCategoryIdstringобязательный

delete-timesheet

Удаляет существующий расчётный табель учёта рабочего времени в Xero по его ID.

Параметры

timesheetIDstringобязательный
The ID of the timesheet to delete.

get-timesheet

Получает один табель учёта рабочего времени из Xero по его ID. Возвращает такие данные, как ID табеля, ID сотрудника, даты начала и окончания, общее количество часов и дату последнего обновления.

Параметры

timesheetIDstringобязательный
The ID of the timesheet to retrieve.

list-accounts

Перечисляет все счета в Xero. Используйте этот инструмент, чтобы получить коды и названия счетов для использования при создании счетов-фактур в Xero.

Параметры

Без параметров.

list-aged-payables-by-contact

Выводит список просроченной кредиторской задолженности в Xero. Показывает просроченную кредиторскую задолженность для конкретного контакта на определённую отчётную дату.

Параметры

contactIdstringобязательный
invoicesFromDatestring
Optional from date in YYYY-MM-DD format. If provided, will only show payable invoices after this date for the contact.
invoicesToDatestring
Optional to date in YYYY-MM-DD format. If provided, will only show payable invoices before this date for the contact.
reportDatestring
Optional date to retrieve aged payables in YYYY-MM-DD format. If none is provided, defaults to end of the current month.

list-aged-receivables-by-contact

Показывает дебиторскую задолженность по срокам в Xero. Отображает задолженность по срокам для конкретного контрагента на определённую дату отчёта.

Параметры

contactIdstringобязательный
invoicesFromDatestring
Optional from date in YYYY-MM-DD format. If provided, will only show payable invoices after this date for the contact.
invoicesToDatestring
Optional to date in YYYY-MM-DD format. If provided, will only show payable invoices before this date for the contact.
reportDatestring
Optional date to retrieve aged receivables in YYYY-MM-DD format. If none is provided, defaults to end of the current month.

list-bank-transactions

Вывести все банковские транзакции в Xero. Спросите пользователя, хочет ли он увидеть банковские транзакции для конкретного банковского счета, или все банковские транзакции, перед выполнением. Спросите пользователя, хочет ли он следующую страницу выписок после выполнения этого инструмента, если возвращено 10 банковских транзакций. Если да, снова вызовите этот инструмент с номером следующей страницы и банковским счетом, если он был указан в предыдущем вызове.

Параметры

bankAccountIdstring
pagenumberобязательный

list-contact-groups

Выводит список всех контактных групп в Xero. При необходимости можно указать ID контактной группы, чтобы получить детали по этой группе, включая её контакты.

Параметры

contactGroupIdstring
Optional ID of the contact group to retrieve

list-contacts

Выведи список всех контактов в Xero. Включая поставщиков и клиентов.

Параметры

pagenumber
Optional page number to retrieve for pagination. If not provided, the first page will be returned. If 100 contacts are returned, call this tool again with the next page number.
searchTermstring
Search parameter that performs a case-insensitive text search across the Name, FirstName, LastName, ContactNumber and EmailAddress fields

list-credit-notes

Показывает кредит-ноты в Xero.Перед выполнением спросите у пользователя, хочет ли он увидеть кредит-ноты для конкретного контакта или все.Если после вызова будет возвращено 10 кредит-нот, спросите у пользователя, хочет ли он увидеть следующую страницу.Если да, вызовите этот инструмент снова, передав следующий номер страницы и контакт, если он был указан в предыдущем вызове.

Параметры

contactIdstring
pagenumberобязательный

list-invoices

Вывести список счетов в Xero. Включает счета со статусами Draft, Submitted и Paid. Спросите пользователя, хочет ли он увидеть счета для конкретного контакта, номер счета или все счета перед запуском. Спросите пользователя, хочет ли он увидеть следующую страницу счетов после запуска этого инструмента, если возвращено 10 счетов. Если он хочет следующую страницу, вызовите этот инструмент снова с номером следующей страницы и контактом или номером счета, если он был указан в предыдущем вызове.

Параметры

contactIdsstring[]
invoiceNumbersstring[]
If provided, invoice line items will also be returned
pagenumberобязательный

list-items

Выводит список всех товаров в Xero. Используйте этот инструмент, чтобы получить коды и описания товаров для создания счетов в Xero.

Параметры

pagenumberобязательный

list-manual-journals

Выводит список всех ручных журналов из Xero. Перед запуском спросите пользователя, хочет ли он увидеть конкретный ручной журнал или все. Опционально можно передать ID ручного журнала, чтобы получить конкретный журнал, или дату, чтобы отфильтровать журналы, изменённые после этой даты. Ответ показывает полный обзор всех ручных журналов, зарегистрированных в вашем аккаунте Xero, с их деталями. После запуска этого инструмента, если возвращено 10 ручных журналов, спросите пользователя, хочет ли он следующую страницу. Если он хочет следующую страницу, вызовите этот инструмент снова с номером следующей страницы, датой изменения и ID ручного журнала, если он был передан в предыдущем вызове.

Параметры

manualJournalIdstring
Optional ID of the manual journal to retrieve
modifiedAfterstring
Optional date YYYY-MM-DD to filter journals modified after this date
pagenumber
Optional page number for pagination

list-organisation-details

Выводит сведения об организации из Xero. Используйте этот инструмент, чтобы получить информацию о текущей организации Xero.

Параметры

Без параметров.

list-payments

Выводит список платежей в Xero. Показывает все платежи по счетам: дату, сумму и способ оплаты. Можно отфильтровать платежи по номеру счёта, ID счёта, ID платежа или ссылке на счёт. Перед запуском спросите пользователя, хочет ли он увидеть платежи по конкретному счёту, контакту, платежу или ссылке. Если возвращается много платежей, спросите пользователя, хочет ли он увидеть следующую страницу.

Параметры

invoiceIdstring
invoiceNumberstring
pagenumber
paymentIdstring
referencestring

list-payroll-employee-leave

Выводит все записи об отпусках для конкретного сотрудника в Xero. Показывает все операции по отпускам, включая утверждённые, ожидающие и обработанные отгулы. Укажите ID сотрудника, чтобы увидеть историю его отпусков.

Параметры

employeeIdstringобязательный
The Xero employee ID to fetch leave records for

list-payroll-employee-leave-balances

Выводит все остатки отпусков для конкретного сотрудника в Xero. Показывает текущие остатки отпусков для всех типов отпусков, доступных сотруднику, включая ежегодный, больничный и другие типы отпусков.

Параметры

employeeIdstringобязательный
The Xero employee ID to fetch leave balances for

list-payroll-employee-leave-types

Выводит список всех типов отпусков, доступных для конкретного сотрудника в Xero. Показывает подробную информацию о типах отпусков, которые может взять сотрудник, включая график начисления, название типа отпуска и положенное количество.

Параметры

employeeIdstringобязательный
The Xero employee ID to fetch leave types for

list-payroll-employees

Выводит список всех сотрудников зарплаты в Xero. Запрашивает полные сведения о сотрудниках: имена, идентификаторы пользователей, даты рождения, адреса электронной почты, пол, номера телефонов, даты начала работы, типы занятости (Permanent, FixedTerm или Casual), должности и даты последнего обновления записей. Ответ содержит полный обзор всех сотрудников, зарегистрированных в вашей зарплатной системе Xero, с личными и трудовыми данными. Если сотрудников много, спросите пользователя, не хочет ли он увидеть более подробную информацию о конкретных сотрудниках, прежде чем продолжить.

Параметры

Без параметров.

list-payroll-leave-periods

Выводит все периоды отпуска для конкретного сотрудника в Xero. Показывает подробные сведения о периодах отсутствия: даты начала и окончания, статус периода, даты выплат и типы отпусков. Укажите ID сотрудника, чтобы увидеть его периоды отпуска.

Параметры

employeeIdstringобязательный
The Xero employee ID to fetch leave periods for
endDatestring
Optional end date in YYYY-MM-DD format
startDatestring
Optional start date in YYYY-MM-DD format

list-payroll-leave-types

Выводит список всех доступных типов отпусков в Xero Payroll. Предоставляет информацию о всех категориях отпусков, настроенных в вашей системе Xero, включая установленные законом и специфические для организации типы отпусков.

Параметры

Без параметров.

list-profit-and-loss

Выводит отчёт о прибылях и убытках в Xero. Он показывает сводку доходов, расходов и прибыли или убытка за заданный период времени.

Параметры

fromDatestring
Optional start date in YYYY-MM-DD format
paymentsOnlyboolean
Optional flag to include only accounts with payments
periodsnumber
Optional number of periods to compare
standardLayoutboolean
Optional flag to use standard layout
timeframeenum
Optional timeframe for the report (MONTH, QUARTER, YEAR)
toDatestring
Optional end date in YYYY-MM-DD format

list-quotes

Вывести все предложения в Xero. Перед выполнением спросите пользователя, хочет ли он увидеть предложения для конкретного контакта. После выполнения этого инструмента, если возвращено 10 предложений, спросите пользователя, хочет ли он следующую страницу предложений. Если да, вызовите этот инструмент снова с номером страницы и контактом, указанными в предыдущем вызове.

Параметры

contactIdstring
pagenumberобязательный
quoteNumberstring

list-report-balance-sheet

Выведи отчёт Balance Sheet из Xero.

Параметры

datestring
Optional date in YYYY-MM-DD format
paymentsOnlyboolean
Optional flag to include only accounts with payments
periodsnumber
Optional number of periods to compare
standardLayoutboolean
Optional flag to use standard layout
timeframeenum
Optional timeframe for the report (MONTH, QUARTER, YEAR)
trackingOptionID1string
Optional tracking option ID 1
trackingOptionID2string
Optional tracking option ID 2

list-tax-rates

Перечисляет все налоговые ставки в Xero. Используйте этот инструмент, чтобы получить налоговые ставки, которые будут применяться при создании счетов в Xero.

Параметры

Без параметров.

list-timesheets

List all payroll timesheets in Xero. Этот инструмент возвращает подробные данные о табелях учёта рабочего времени: идентификаторы табелей, идентификаторы сотрудников, даты начала и окончания, общее количество часов и дату последнего обновления.

Параметры

Без параметров.

list-tracking-categories

Перечисляет все категории отслеживания в Xero, а также связанные с ними параметры отслеживания.

Параметры

includeArchivedboolean
Determines whether or not archived categories will be returned. By default, no archived categories will be returned.

list-trial-balance

Выводит пробный баланс в Xero. Это дает снимок главной книги, показывая дебетовые и кредитовые остатки по каждому счету.

Параметры

datestring
Optional date in YYYY-MM-DD format
paymentsOnlyboolean
Optional flag to include only accounts with payments

revert-timesheet

Откатить расчетный табель до черновика в Xero по его ID.

Параметры

timesheetIDstringобязательный
The ID of the timesheet to revert.

update-bank-transaction

Обновляет банковскую транзакцию в Xero. При обновлении банковской транзакции возвращается deep link на эту транзакцию в Xero. Этот deep link можно использовать для прямого просмотра банковской транзакции в Xero. Эту ссылку нужно показать пользователю.

Параметры

bankTransactionIdstringобязательный
contactIdstring
datestring
lineItemsobject[]
All line items must be provided. Any line items not provided will be removed. Including existing line items. Do not modify line items that have not been specified by the user
referencestring
typeenum

update-contact

Обновляет контакт в Xero. После обновления контакта возвращается глубокая ссылка на контакт в Xero. Эту глубокую ссылку можно использовать для просмотра контакта прямо в Xero. Эту ссылку нужно показать пользователю.

Параметры

addressobject
contactIdstringобязательный
emailstring
firstNamestring
lastNamestring
namestringобязательный
phonestring

update-credit-note

Обновляет кредит-ноту в Xero. Работает только с черновиками кредит-нот. Все позиции должны быть указаны. Любые позиции, не указанные, будут удалены, включая существующие. Не изменяйте позиции, которые не указал пользователь. Когда кредит-нота обновляется, возвращается глубокая ссылка на неё в Xero. По этой ссылке можно напрямую открыть кредит-ноту в Xero. Ссылку нужно показать пользователю.

Параметры

contactIdstring
creditNoteIdstringобязательный
datestring
lineItemsobject[]
All line items must be provided. Any line items not provided will be removed. Including existing line items. Do not modify line items that have not been specified by the user
referencestring

update-invoice

Обновляет счёт в Xero. Работает только с черновиками. Нужно передать все позиции — те, что не указаны, будут удалены. Включая существующие позиции. Не изменяй позиции, которые не указал пользователь. После обновления счёта возвращается глубокая ссылка на него в Xero. По ней можно сразу открыть контакт в Xero. Эту ссылку нужно показать пользователю.

Параметры

contactIdstring
The ID of the contact to update the invoice for. Can be obtained from the list-contacts tool.
datestring
The date of the invoice.
dueDatestring
The due date of the invoice.
invoiceIdstringобязательный
The ID of the invoice to update.
lineItemsobject[]
All line items must be provided. Any line items not provided will be removed. Including existing line items. Do not modify line items that have not been specified by the user
referencestring
A reference number for the invoice.

update-item

Обновить элемент в Xero.

Параметры

codestringобязательный
descriptionstring
inventoryAssetAccountCodestring
isTrackedAsInventoryboolean
itemIdstringобязательный
namestringобязательный
purchaseDescriptionstring
purchaseDetailsobject
salesDetailsobject

update-manual-journal

Обновляет ручной журнал в Xero. Работает только с черновиками ручных журналов. Не изменяйте строки или параметры, которые не указал пользователь.

Параметры

datestring
Optional date in YYYY-MM-DD format
lineAmountTypesenum
Optional line amount types (EXCLUSIVE, INCLUSIVE, NO_TAX), NO_TAX by default
manualJournalIDstringобязательный
ID of the manual journal to update
manualJournalLinesobject[]обязательный
The manualJournalLines element must contain at least two individual manualJournalLine sub-elements
narrationstringобязательный
Description of manual journal being posted
showOnCashBasisReportsboolean
Optional boolean to show on cash basis reports, default is true
statusenum
Optional status of the manual journal (DRAFT, POSTED, DELETED, VOIDED, ARCHIVED), DRAFT by default
urlstring
Optional URL link to a source document

update-quote

Обновляет предложение в Xero. Работает только с черновиками предложений. Все позиции должны быть указаны. Любые позиции, не указанные, будут удалены — включая существующие. Не изменяйте позиции, которые не указал пользователь. При обновлении предложения возвращается глубокая ссылка на предложение в Xero. По этой ссылке можно открыть предложение напрямую в Xero. Эту ссылку нужно показать пользователю.

Параметры

contactIdstring
datestring
expiryDatestring
lineItemsobject[]
All line items must be provided. Any line items not provided will be removed. Including existing line items. Do not modify line items that have not been specified by the user
quoteIdstringобязательный
quoteNumberstring
referencestring
summarystring
termsstring
titlestring

update-timesheet-line

Обновить существующую строку табеля рабочего времени в расчётном табеле Xero.

Параметры

timesheetIDstringобязательный
The ID of the timesheet to update.
timesheetLineobjectобязательный
The details of the timesheet line to update.
timesheetLineIDstringобязательный
The ID of the timesheet line to update.

update-tracking-category

Обновляет существующую категорию отслеживания в Xero.

Параметры

namestring
statusenum
trackingCategoryIdstringобязательный

update-tracking-options

Обновляет параметры отслеживания для категории отслеживания в Xero.

Параметры

optionsobject[]обязательный
trackingCategoryIdstringобязательный

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@xeroapi/xero-mcp-server@latest"
  ],
  "env": {
    "XERO_CLIENT_ID": "your_client_id_here",
    "XERO_CLIENT_SECRET": "your_client_secret_here",
    "XERO_SCOPES": "accounting.invoices accounting.contacts accounting.settings"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот сервер соединяет Xero с MCP-протоколом, чтобы AI-ассистенты напрямую управляли бухгалтерией. Вместо ручного переноса данных он даёт команды для создания счетов, контактов, проводок и получения отчётов. Разработчику не нужно писать отдельную интеграцию — достаточно настроить OAuth2 и работать через единый интерфейс.

Что он умеет?

Управляет контактами и контактными группами: создает, обновляет и читает их. Работает с инвойсами, кредит-нотами, котировками и платежами: создает, обновляет, проводит оплаты. Создает, обновляет и читает банковские транзакции, товары и ручные журналы. Читает данные организации, план счетов, налоговые ставки, трекинг-категории и их опции, создает и обновляет их. В зарплатном модуле управляет сотрудниками, табелями, отпусками и балансами: создает, меняет, одобряет, откатывает и удаляет табели. Формирует отчеты: P&L, баланс, оборотно-сальдовую ведомость, дебиторку и кредиторку по контактам.