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 in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Sage Accounting in the guided setup, then add your MCP URL to Claude. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.
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.
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) + Claude
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.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
SAGE_ZA_API_HOST, SAGE_ZA_USERNAME, SAGE_ZA_PASSWORD, SAGE_ZA_API_KEY
Step 1 — Get credentials
Setting up takes about keys take up to 2 working days.
- 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 intoSAGE_ZA_API_KEY. - 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. - Enter the e-mail address and password of a Sage Accounting user in
SAGE_ZA_USERNAMEandSAGE_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). - Optional: put the ID of the company the assistant works in into
SAGE_ZA_COMPANY_ID. Find it withsage_accounting_za_list_companies. Without it, passcompany_idon 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.
Step 2 — Install the adapter
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
Step 3 — Add the connector in Claude
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Recommended path: works on claude.ai web without editing any config file.
- In Claude, open Plugins (still called Customize on some plans) → Connectors.
- Click + Add, then Add custom connector.
- Enter a name, e.g.
Sage Accounting (South Africa), and the remote MCP server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Continue, keep the detected settings and click Continue again. - Choose Sign in now, click Add and sign in to AnythingMCP (OAuth) to allow access.
All tools below appear in your chat: start typing prompts.
Available tools
| Tool | What it does |
|---|---|
sage_accounting_za_list_companies | List the companies this Sage login can open: ID, Name, CurrencySymbol, TaxNumber, RegisteredName, CountryId, Active, IsOwner… |
sage_accounting_za_list_customers | List customers: ID, Name, Category, ContactName, Email, Telephone, Mobile, TaxReference, Balance, CreditLimit, postal and delivery address… |
sage_accounting_za_get_customer | Read one customer with every field: name, category, contact, tax reference, balance, credit limit, addresses, default tax type, price list… |
sage_accounting_za_list_suppliers | List suppliers: ID, Name, Category, ContactName, Email, Telephone, TaxReference, Balance, CreditLimit, address lines, Active and Modified.… |
sage_accounting_za_get_supplier | Read one supplier with every field: name, category, contact details, tax reference, balance, addresses, default tax type, currency and due… |
sage_accounting_za_list_items | List items (products and services): ID, Code, Description, Category, PriceExclusive, PriceInclusive, LastCost, Unit, Physical (stock item… |
sage_accounting_za_get_item | Read 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_invoices | List tax invoices (sales invoices): ID, DocumentNumber, Date, DueDate, CustomerId, CustomerName, Reference, Exclusive, Tax, Total… |
sage_accounting_za_get_tax_invoice | Read one tax invoice with its lines: document number, dates, customer, addresses, discount, Exclusive, Tax, Total, AmountDue and per line… |
sage_accounting_za_list_quotes | List quotes: ID, DocumentNumber, Date, ExpiryDate, CustomerId, CustomerName, Reference, Exclusive, Tax, Total and Status. Read-only, 100… |
sage_accounting_za_get_quote | Read 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_invoices | List supplier invoices (purchase invoices): ID, DocumentNumber, Date, DueDate, SupplierId, SupplierName, Reference, Exclusive, Tax, Total… |
sage_accounting_za_get_supplier_invoice | Read one supplier invoice with its lines: document number, dates, supplier, reference, Exclusive, Tax, Total, AmountDue and per line the… |
sage_accounting_za_list_accounts | List the ledger accounts (chart of accounts without system accounts): ID, Name, Description, Category (ID and Description), Balance… |
sage_accounting_za_list_account_categories | List 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_types | List 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_accounts | List bank and credit card accounts: ID, Name, BankName, AccountNumber, BranchNumber, Category, Balance, Default, CurrencyId… |
sage_accounting_za_list_bank_transactions | List bank transactions of the cashbook: ID, BankAccountId, Date, Type, Payee, Description, Reference, DocumentNumber, Exclusive, Tax… |
sage_accounting_za_list_customer_receipts | List customer receipts (payments received): ID, CustomerId, Date, DocumentNumber, Reference, Description, Total, Discount… |
sage_accounting_za_get_customer_ageing | Customer (debtors) ageing in detail: per customer the outstanding documents with date, document number, reference and the amount in each… |
sage_accounting_za_get_supplier_ageing | Supplier (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_documents | List 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_loss | Profit 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_sheet | Balance sheet as at one date: a tree of reporting levels (assets, liabilities, equity) with Description, AccountNumber, Category, Children… |
sage_accounting_za_get_account_balances | Movement per ledger account over a date range, like a trial balance: account ID, Description, CategoryId, CategoryDescription, Debit… |
sage_accounting_za_save_customer | Create 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_supplier | Create 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_item | Create 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_account | Create 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_quote | Work 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_quote | Create 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_invoice | Work 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_invoice | Create 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?"
FAQ
Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
What do I need to sign in? An API key from Sage's developer programme (request it on the developer page; it can take up to 2 working days), the site you sign in at, and the e-mail and password of a Sage Accounting user. A dedicated user with only the access the assistant needs is recommended: 20 failed sign-ins within an hour block the user for 24 hours.
Is this the global Sage Accounting? No. It is the South African edition of Sage Business Cloud Accounting, the former Sage One and Sage Pastel My Business Online, also used in other African markets served from the same platform. For the UK, Ireland, North America and Europe use the Sage Business Cloud connector.
What can it change, and does it move money? It creates and updates customers, suppliers, items, accounts, quotes and tax invoices, with calculate tools to preview totals first. Bank accounts, bank transactions and customer receipts are read-only: it records no receipts or payments, never moves money and deletes nothing. Nothing installs switched off.
Next steps
- Connector landing page
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
- Connect to Microsoft Copilot
Was this guide helpful?