Каталог MCP
xeroapi/xero-mcp-server

xeroapi/xero-mcp-server

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

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.

Инструменты были проиндексированы: 11.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 по его ID.

Параметры

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. Этот инструмент записывает платёжную операцию по счёту. Вам нужно указать идентификатор счёта, идентификатор аккаунта, с которого будет сделан платёж, и сумму. Сумма должна быть положительной и не должна превышать оставшуюся сумму к оплате по счёту. Платёж можно создать только для счёта со статусом 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

Создает предложение (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 по его идентификатору. Это предоставляет такие сведения, как идентификатор табеля, идентификатор сотрудника, даты начала и окончания, общее количество часов и дату последнего обновления.

Параметры

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. Вы можете дополнительно указать идентификатор группы контактов, чтобы получить сведения об этой конкретной группе, включая её контакты.

Параметры

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. Сюда входят счета со статусами Черновик, Отправлен и Оплачен. Перед вызовом инструмента спросите у пользователя, хочет ли он видеть счета по конкретному контакту, номеру счета или все счета. Если после вызова инструмент вернул 10 счетов, спросите у пользователя, нужна ли ему следующая страница счетов. Если нужна, вызовите этот инструмент снова, передав номер следующей страницы, а также контакт или номер счета, если они были указаны в предыдущем вызове.

Параметры

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

list-items

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

Параметры

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

list-manual-journals

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

Параметры

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. Показывает все платежи по счетам, включая дату платежа, сумму и способ оплаты. Платежи можно фильтровать по номеру счёта, идентификатору счёта, идентификатору платежа или ссылке на счёт. Перед запуском уточните у пользователя, хочет ли он видеть платежи по конкретному счёту, контакту, платежу или ссылке. Если платежей много, спросите, хочет ли пользователь увидеть следующую страницу.

Параметры

invoiceIdstring
invoiceNumberstring
pagenumber
paymentIdstring
referencestring

list-payroll-employee-leave

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

Параметры

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. Возвращает подробные данные о сотрудниках, включая имена, User ID, даты рождения, адреса электронной почты, пол, номера телефонов, даты начала работы, типы занятости (Permanent, FixedTerm или Casual), должности и дату последнего обновления записей. Ответ содержит полную сводку по всем сотрудникам, зарегистрированным в вашей зарплатной ведомости Xero, с их личными данными и сведениями о занятости. Если сотрудников много, спросите пользователя, не хочет ли он увидеть более подробную информацию о конкретных сотрудниках, прежде чем продолжить.

Параметры

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

list-payroll-leave-periods

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

Параметры

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

Перечисляет все табели учёта рабочего времени в 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 по его идентификатору.

Параметры

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

update-bank-transaction

Обновляет банковскую операцию в Xero. Когда банковская операция обновляется, возвращается глубокая ссылка на неё в Xero. По этой ссылке можно открыть банковскую операцию прямо в 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. При обновлении контакта возвращается deep link на контакт в Xero. Этот deep link можно использовать, чтобы просмотреть контакт прямо в 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

Что он умеет?

Сервер работает с контактами и контакт-группами: читает, создает и обновляет их. Создает, читает и обновляет счета, кредит-ноты, цитаты, платежи, банковские транзакции, ручные журналы, товары и налоговые ставки. Управляет tracking-категориями и их опциями. В payroll-модуле ведет сотрудников, таймшиты (создает, дополняет, утверждает, откатывает, удаляет) и отпуска с балансами. Формирует отчеты: прибыли и убытки, балансовый отчет, пробный баланс, дебиторскую и кредиторскую задолженность по контактам.

Информация о сервере

Номер в рейтинге: #152
Звезд на Github: 364
Форков на Github: 187
Загрузок: 78 137
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 22:46
Идентификатор: VNwmU2C1YxNUN6sl
Категории: CRM, ERP-системы, Агенты, Инструменты для разработчиков, Платежи и выставление счетов, Финансы