Connector guide9-minute read33 MCP tools7 languages

Sage Accounting MCP Server: Invoices, Quotes and Reports

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

HCBy HelpCode teamUpdated 9 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Sage Accounting (South Africa)

Sage Accounting (South Africa)

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

tools

33

Region

INTL

Category

Accounting

Authentication

Basic Auth

Required env vars

SAGE_ZA_API_HOSTSAGE_ZA_USERNAMESAGE_ZA_PASSWORDSAGE_ZA_API_KEY
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

Guided setup

Connect Sage Accounting to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Sage Accounting in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Sage Accounting (South Africa)

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Sage Accounting (South Africa) · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Sage Accounting (South Africa), paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Sage Accounting (South Africa)

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

Setup

Setting up takes about keys take up to 2 working days.

  1. Request an API key on https://accounting.sageone.co.za/marketing/developerprogram.aspx (Request your API Key). Sage issues one key per application; it looks like 39478ac6-ac2a-44d8-a31c-7e7e14af4de3. Paste it into SAGE_ZA_API_KEY.
  2. Pick the site you sign in at in SAGE_ZA_API_HOST: accounting.sageone.co.za for most accounts, or resellers.accounting.sageone.co.za when that is your login page.
  3. Enter the e-mail address and password of a Sage Accounting user in SAGE_ZA_USERNAME and SAGE_ZA_PASSWORD. The API uses HTTP Basic authentication with the same sign-in as the web application, so a dedicated user with only the access the assistant needs is recommended. An invited user only reaches the functions their role allows (other calls answer 405).
  4. Optional: put the ID of the company the assistant works in into SAGE_ZA_COMPANY_ID. Find it with sage_accounting_za_list_companies. Without it, pass company_id on every call.

Where to start: sage_accounting_za_list_companies shows the companies of the login and their ID. Every other tool works inside one company (company_id, or the default of the connector).

Customers, suppliers, items: sage_accounting_za_list_customers, sage_accounting_za_get_customer, sage_accounting_za_list_suppliers, sage_accounting_za_get_supplier, sage_accounting_za_list_items, sage_accounting_za_get_item. Create or change them with sage_accounting_za_save_customer, sage_accounting_za_save_supplier and sage_accounting_za_save_item.

Sales and purchase documents: sage_accounting_za_list_tax_invoices and sage_accounting_za_get_tax_invoice (sales invoices), sage_accounting_za_list_quotes and sage_accounting_za_get_quote, sage_accounting_za_list_supplier_invoices and sage_accounting_za_get_supplier_invoice. List tools return headers only unless include_detail is true. Write a quote with sage_accounting_za_save_quote and an invoice with sage_accounting_za_save_tax_invoice; preview totals first with sage_accounting_za_calculate_quote or sage_accounting_za_calculate_tax_invoice. A line names an item (LineType 0) or a ledger account (LineType 1) in SelectionId, with Quantity, a unit price and a TaxTypeId. If a saved document comes back with zero totals, pass the lines exactly as the calculate tool returned them.

Ledger and banking: sage_accounting_za_list_accounts, sage_accounting_za_list_account_categories and sage_accounting_za_list_tax_types describe the chart of accounts; sage_accounting_za_save_account adds or changes an account. sage_accounting_za_list_bank_accounts, sage_accounting_za_list_bank_transactions and sage_accounting_za_list_customer_receipts are read-only: this connector does not record receipts or payments and never moves money.

Reports: sage_accounting_za_get_customer_ageing and sage_accounting_za_get_supplier_ageing (who owes what, by age), sage_accounting_za_list_outstanding_customer_documents, sage_accounting_za_get_profit_and_loss, sage_accounting_za_get_balance_sheet and sage_accounting_za_get_account_balances (movement per account, like a trial balance). These are POST calls that only read.

Saving: a Save without id creates a record; with id it replaces that record. Sage stores the record as it is sent, so a field left out of an update can be reset: read the record first and pass what must stay in extra_fields. New records are active unless active is false. Nothing is deleted by this connector.

Filtering and paging: list tools accept a subset of OData. filter and orderby work on numbers, booleans and dates only, never on text (search names by reading the list). Date literals are written DateTime'2026-01-31'; if Sage rejects that form, try the quoted date alone. Every list is capped at 100 rows: the answer is wrapped as TotalResults, ReturnedResults and Results; raise skip by 100 until you have TotalResults rows.

Limits: 100 requests per minute per company and 5,000 per day per user. Going over the minute limit blocks the IP address for an hour (HTTP 429), so keep to about one call per second and do not retry in a loop. 20 failed sign-ins within an hour block the user for 24 hours: after a 401, stop and have the credentials checked.

Fields and formats: IDs are integers. Dates are YYYY-MM-DD. Amounts are decimals in the company currency unless a customer or supplier has its own currency (see Customer_CurrencyId and the exchange rate on the document). Exclusive is the amount before tax, Tax the VAT and Total the amount including tax. Errors: 400 carries the validation messages, 402 means the Sage subscription expired, 404 that the record is not in this company, 409 that a record is in use.

Prerequisites: SAGE_ZA_API_HOST, SAGE_ZA_USERNAME, SAGE_ZA_PASSWORD, SAGE_ZA_API_KEY

Install the connector locally

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Open http://localhost:3000/connectors/store, pick Sage Accounting (South Africa) and paste in the env vars listed under Prerequisites.

Available tools

ToolWhat it does
sage_accounting_za_list_companiesList the companies this Sage login can open: ID, Name, CurrencySymbol, TaxNumber, RegisteredName, CountryId, Active, IsOwner…
sage_accounting_za_list_customersList customers: ID, Name, Category, ContactName, Email, Telephone, Mobile, TaxReference, Balance, CreditLimit, postal and delivery address…
sage_accounting_za_get_customerRead one customer with every field: name, category, contact, tax reference, balance, credit limit, addresses, default tax type, price list…
sage_accounting_za_list_suppliersList suppliers: ID, Name, Category, ContactName, Email, Telephone, TaxReference, Balance, CreditLimit, address lines, Active and Modified.…
sage_accounting_za_get_supplierRead one supplier with every field: name, category, contact details, tax reference, balance, addresses, default tax type, currency and due…
sage_accounting_za_list_itemsList items (products and services): ID, Code, Description, Category, PriceExclusive, PriceInclusive, LastCost, Unit, Physical (stock item…
sage_accounting_za_get_itemRead one item with every field: code, description, category, selling prices, last cost, unit, tax types, reporting groups and user-defined…
sage_accounting_za_list_tax_invoicesList tax invoices (sales invoices): ID, DocumentNumber, Date, DueDate, CustomerId, CustomerName, Reference, Exclusive, Tax, Total…
sage_accounting_za_get_tax_invoiceRead one tax invoice with its lines: document number, dates, customer, addresses, discount, Exclusive, Tax, Total, AmountDue and per line…
sage_accounting_za_list_quotesList quotes: ID, DocumentNumber, Date, ExpiryDate, CustomerId, CustomerName, Reference, Exclusive, Tax, Total and Status. Read-only, 100…
sage_accounting_za_get_quoteRead one quote with its lines: document number, date, expiry date, customer, discount, totals, status and per line the item or account…
sage_accounting_za_list_supplier_invoicesList supplier invoices (purchase invoices): ID, DocumentNumber, Date, DueDate, SupplierId, SupplierName, Reference, Exclusive, Tax, Total…
sage_accounting_za_get_supplier_invoiceRead one supplier invoice with its lines: document number, dates, supplier, reference, Exclusive, Tax, Total, AmountDue and per line the…
sage_accounting_za_list_accountsList the ledger accounts (chart of accounts without system accounts): ID, Name, Description, Category (ID and Description), Balance…
sage_accounting_za_list_account_categoriesList the account categories (Sales, Cost of Sales, Expenses, Current Assets and so on): ID, Description and Order. The ID is the category…
sage_accounting_za_list_tax_typesList the tax (VAT) types of the company: ID, Name, Percentage, IsDefault and Active. The ID is the TaxTypeId of document lines, items and…
sage_accounting_za_list_bank_accountsList bank and credit card accounts: ID, Name, BankName, AccountNumber, BranchNumber, Category, Balance, Default, CurrencyId…
sage_accounting_za_list_bank_transactionsList bank transactions of the cashbook: ID, BankAccountId, Date, Type, Payee, Description, Reference, DocumentNumber, Exclusive, Tax…
sage_accounting_za_list_customer_receiptsList customer receipts (payments received): ID, CustomerId, Date, DocumentNumber, Reference, Description, Total, Discount…
sage_accounting_za_get_customer_ageingCustomer (debtors) ageing in detail: per customer the outstanding documents with date, document number, reference and the amount in each…
sage_accounting_za_get_supplier_ageingSupplier (creditors) ageing in detail: per supplier the outstanding documents with date, document number, reference and the amount in each…
sage_accounting_za_list_outstanding_customer_documentsList the unpaid documents of one customer (tax invoices, and with include_paid_invoices also paid ones): document type, number, date…
sage_accounting_za_get_profit_and_lossProfit and loss (income statement) for a date range: a tree of reporting levels (Sales, Cost of Sales, Gross Profit, Expenses, Net Profit)…
sage_accounting_za_get_balance_sheetBalance sheet as at one date: a tree of reporting levels (assets, liabilities, equity) with Description, AccountNumber, Category, Children…
sage_accounting_za_get_account_balancesMovement per ledger account over a date range, like a trial balance: account ID, Description, CategoryId, CategoryDescription, Debit…
sage_accounting_za_save_customerCreate a customer, or update one when id is given. Returns the saved customer with its ID. A Save replaces the whole record: for an update…
sage_accounting_za_save_supplierCreate a supplier, or update one when id is given. Returns the saved supplier with its ID. A Save replaces the whole record: for an update…
sage_accounting_za_save_itemCreate an item (product or service), or update one when id is given. Returns the saved item with its ID. A Save replaces the whole record…
sage_accounting_za_save_accountCreate a ledger account, or update one when id is given. Returns the saved account with its ID. The category decides where the account…
sage_accounting_za_calculate_quoteWork out the totals of a quote without saving it: returns the document with Exclusive, Tax, Total and Discount per line and for the whole…
sage_accounting_za_save_quoteCreate a quote for a customer, or update one when id is given. Returns the saved quote with its ID, DocumentNumber and totals. Check the…
sage_accounting_za_calculate_tax_invoiceWork out the totals of a tax invoice without saving it: returns the document with Exclusive, Tax, Total and Discount per line and for the…
sage_accounting_za_save_tax_invoiceCreate a tax invoice (sales invoice) for a customer, or update one when id is given. Returns the saved invoice with its ID, DocumentNumber…

Example prompts

  • "Which customers owe us money for more than 60 days?"
  • "Show the profit and loss for the last financial quarter."
  • "Preview a tax invoice for Acme Trading: 10 hours consulting at R950, then save it."
  • "List supplier invoices from October that are still outstanding."
  • "What are the balances of our bank accounts and the latest transactions?"

Next steps

Was this guide helpful?

Connect Sage Accounting to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Sage Accounting in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

Related guides

Connectors

Connect Sage Accounting to ChatGPT via MCP

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

Connectors

Connect Sage Accounting to Claude via MCP

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

Connectors

Connect Sage Accounting to Microsoft Copilot via MCP

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

Connectors

Connect Sage Accounting to Cursor via MCP

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

Connectors

Connect Sage Accounting to Gemini CLI via MCP

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

Connectors

Connect Sage Accounting to Meta Muse via MCP

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.