# Paulgosnell Accountsos MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.paulgosnell%2Faccountsos-mcp
Registry id: `mcp-registry/io.github.paulgosnell/accountsos-mcp`
Status: live (checked 2026-11-22T17:09:19.832Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 1018
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "paulgosnell-accountsos-mcp-server": {
      "type": "http",
      "url": "https://accounts-os.com/api/mcp/plugin"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http paulgosnell-accountsos-mcp-server https://accounts-os.com/api/mcp/plugin
```

## Tools (90)

- `add_document`: Add a file the user attached in this chat to their AccountsOS books: a bank statement, a receipt, a supplier bill or a sales invoice. AccountsOS reads it the sa
- `calculate_vat_period`: Preview the 9-box VAT breakdown for a period WITHOUT locking it. Computes the boxes from the period's transactions using the same logic as the VAT page, so the 
- `categorize_transaction`: Get AI-suggested category for a transaction
- `check_company`: Check a UK limited company on its public Companies House record and show it as a card: when its accounts, confirmation statement and Corporation Tax are due, wh
- `check_vat_number`: Check a UK VAT registration number against HMRC's live Check-a-UK-VAT-number register and return the registered trader name and address. GB only. A "not registe
- `compare_salary_dividends`: Work out the most tax-efficient mix of salary and dividends for a UK limited company director from the company's profit, against taking it all as salary. An est
- `compare_sole_trader_vs_ltd`: Compare the tax and take-home of trading in the UK as a sole trader against a limited company, at a given profit. An estimate for the current UK tax year. Needs
- `create_deadline`: Create a new tax/filing deadline reminder
- `create_transaction`: Create a new transaction (with auto-categorization)
- `deel_calculate_employment_cost`: Calculate the total cost of hiring someone in a specific country through Deel EOR. Use when the user asks "how much would it cost to hire in [country]?" or abou
- `deel_calculate_take_home_pay`: Calculate take-home pay for a given salary in a specific country. Use when the user asks about net pay, take-home salary, or deductions in a country.
- `deel_get_invoices`: Get invoices from the user's Deel account. Shows contractor payment invoices. Use when the user asks about Deel payments, contractor invoices, or payment histor
- `deel_get_payment_receipts`: Get payment receipts from Deel showing payments made to contractors. Use when the user asks about specific Deel payments or needs payment proof.
- `deel_get_people`: List people (contractors and employees) in the user's Deel organization. Use when the user asks about their Deel team, workforce, or contractor list.
- `deel_list_contracts`: List contracts from the user's Deel account. Use when the user asks about their Deel contracts, contractors, or team members managed through Deel.
- `estimate_sole_trader_tax`: Estimate the income tax and National Insurance a UK sole trader should set aside, and any payments on account, from their profit. An estimate for the current UK
- `find_duplicate_bank_accounts`: Find manual bank accounts that look like the same real-world account as a live bank feed (Revolut Business, Starling, Wise, Mercury, Qonto, Airwallex, Stripe Tr
- `find_related_documents`: Find documents that might be related to an entity based on amount, vendor, date, and reference matching. Shows both already-linked documents and AI-suggested ma
- `get_accounts_status`: Get the status of annual accounts preparation for the current company. Returns the current accounting period, preparation status, and next steps. Use when the u
- `get_aged_creditors`: Aged creditors report: outstanding bills grouped by supplier, bucketed by days past due (current/not-yet-due, 1-30, 31-60, 61-90, 90+). Use when the user asks "
- `get_aged_debtors`: Aged debtors report: outstanding invoices grouped by contact, bucketed by days past due (current/not-yet-due, 1-30, 31-60, 61-90, 90+). Use when the user asks "
- `get_attention`: Return the proactive, ranked list of everything that currently needs the user's attention across their whole account: missing bank statements, unreconciled tran
- `get_balance`: Get current account balance
- `get_balance_sheet`: Get Balance Sheet report as at a given date.
- `get_bank_accounts`: List bank accounts connected to the company.
- `get_bills`: Get supplier bills/invoices owed by the company. Shows what you owe to suppliers.
- `get_budget_vs_actual`: Budget vs actual: how the company is doing against its budget. Use when the user asks about budget, against budget, over budget, under budget, budget vs actual,
- `get_capital_allowance_hint`: Get a tax capital allowance hint for a fixed asset (book depreciation vs tax relief). GB companies get AIA/WDA guidance from official rates; other countries get
- `get_cash_flow_forecast`: 13-week cash-flow forecast. Returns current bank balance, projected weekly inflows/outflows/running balance for the next 13 weeks, projected low point, recurrin
- `get_chart_of_accounts`: List account categories (chart of accounts). Use when the user asks about their chart of accounts, account codes, or available categories for categorizing trans
- `get_contacts`: List contacts (clients, suppliers, leads). Use when user asks about customers, suppliers, or contacts.
- `get_deadlines`: Get upcoming tax and filing deadlines. Each carries support (files, prepares, workpaper, reminder_only, or null for a payment) and support_note: what AccountsOS
- `get_dividends`: List dividend records. Use when user asks about dividends paid, dividend history, or shareholder payments.
- `get_dla_balance`: Get the Director's Loan Account (DLA) balance and recent transactions. Shows if director owes company or vice versa, with section 455 tax warnings.
- `get_document_links`: Get the documents linked to ONE entity (transaction, invoice, bill, estimate, contact, project, expense claim), or the entities linked to ONE document. Every ca
- `get_estimates`: Get estimates/quotes sent to clients.
- `get_expense_claims`: Get expense claims and reimbursement requests.
- `get_expenses`: List expense claims. Use when the user asks about expenses, expense claims, reimbursements, or receipts they have submitted.
- `get_filed_accounts_history`: The year-by-year figures from the accounts this company has filed at Companies House, newest first: balance sheet lines (fixed assets, current assets, creditors
- `get_financial_snapshot`: Get the headline money figures in one call: cash, what the company is owed (open invoices), what it owes (open bills), and net profit this month, the EXACT numb
- `get_fixed_assets`: List fixed assets on the register with cost, net book value, monthly depreciation and status. Returns total_cost, total_accumulated_depreciation and total_nbv f
- `get_fx_rates`: Exchange rates: the closing rate for a currency pair on a date, or a series over a range. Use when the user asks for an exchange rate, FX, a currency conversion
- `get_gifi_status`: Canada: is my GIFI ready for the T2, which accounts are not mapped or need review, and do the balance checks pass. 'is my GIFI ready', 'GIFI mapping', 'T2 sched
- `get_goals`: Get active business/financial goals and their progress. Use when user asks about their goals, targets, or how they are tracking against objectives.
- `get_gov_guidance`: Search official GOV.UK tax and business guidance. Use when the user asks "what does HMRC say about X?", asks about tax rules, filing requirements, or wants to k
- `get_gst_hst_return`: Canada: prepare the GST/HST return (GST34) for a period: 'GST return', 'HST return', 'GST report', 'what do I owe CRA', 'my Q3 GST'. Returns every line (101 to 
- `get_hmrc_vat_liabilities`: Read the company's VAT liabilities (amounts HMRC says are owed and when they are due) directly from HMRC MTD. Use when the user asks "how much VAT do I owe HMRC
- `get_hmrc_vat_obligations`: Read the company's VAT obligations (the returns HMRC expects, with their period keys, start/end dates, due dates, and whether they are Open or Fulfilled) direct
- `get_hmrc_vat_payments`: Read the VAT payments HMRC has received on the company's account directly from HMRC MTD. Use when the user asks "has HMRC received my VAT payment", "what VAT ha
- `get_income_by_currency`: Currency-split income (or expense) totals in ONE compact call: face totals grouped by each transaction currency (e.g. EUR face vs GBP face) PLUS the company fun
- `get_incoming_messages`: Read the company's Incoming inbox: messages that arrived by email, WhatsApp, Slack or Telegram (sender, subject, preview, attachments and their processing statu
- `get_integration_status`: See every integration for this company and user in one call: what's connected (banks, HMRC MTD, Stripe, Deel, Gmail, WhatsApp, Telegram, Slack, Xero and the res
- `get_invoices`: Get invoices the user has raised, with summary stats on outstanding and overdue amounts. Use when user asks about invoices, outstanding payments, or money owed 
- `get_journal_entries`: Get General Ledger journal entries. Double-entry accounting records.
- `get_month_close`: Check how 'closed' a month's books are. Returns a close-confidence percentage (share of the month's transactions that are categorised AND reconciled) plus exact
- `get_opportunity`: Get detailed information about a specific pipeline opportunity/deal, including notes and activity history.
- `get_payroll_summary`: Get year-to-date payroll figures, last run date, and next payment due. Use when user asks about payroll costs, total salary spend, or when the next payroll run 
- `get_profit_and_loss`: Get Profit and Loss (income statement) report for a period.
- `get_project_pnl`: Get a deal/project's mini P&L: income, costs by category, and net margin, computed from bank transactions linked to it, plus invoice/bill/expense-claim commitme
- `get_projects`: List projects (pipeline, active, completed). Use when the user asks about their projects, deals, or pipeline.
- `get_qfzp_status`: Get the active company's QFZP (Qualifying Free Zone Person) status for UAE Corporate Tax. Returns the qualifying/non-qualifying income split, de minimis status 
- `get_reconciliation_status`: Reconciliation per bank account: every uploaded statement with its own opening and closing balance as printed, the books' balance at its end date, the differenc
- `get_recurring_invoices`: List recurring invoice templates. Use when user asks about recurring invoices, scheduled invoices, or subscription billing.
- `get_risk_flags`: List the entries Finn flagged for a second look before they reach a VAT return: suspect or duplicate receipts and invoices, VAT added to a zero-rated purchase, 
- `get_statement_checks`: Each imported bank statement against the books: the statement's period, its opening and closing balance as printed, the book balance on the statement's end date
- `get_tasks`: Get tasks and to-dos for the company.
- `get_tax_facts`: Look up current UK tax rates, thresholds and allowances (income_tax, national_insurance, corporation_tax, dividends, capital_allowances, vat, pensions, mileage,
- `get_transactions`: Get transactions for the company with optional filters. Returns currency, amount_gbp and exchange_rate. A row with expected_income: true is an uploaded sales in
- `get_trial_balance`: Get Trial Balance showing all account balances.
- `get_vat_periods`: List the company's VAT return periods and their status (open, locked, submitted, failed, overdue), with the net VAT due, due date, and HMRC receipt for any subm
- `get_vat_summary`: Get VAT summary for a calendar quarter, or for any VAT period with start_date and end_date
- `get_year_on_year`: How this year compares with last year and the years before: are we up or down on last year, revenue and profit trend, margin, cash at year end, year on year, sa
- `link_company`: Save a UK (Companies House) or Irish (CRO) company from its official register onto the user's AccountsOS company: registered name, number, status, address, dire
- `list_categories`: List available transaction categories for categorization
- `list_companies`: List the companies this AccountsOS account can see (for an accountancy practice, its clients), with the default one marked. Call this first when the user has mo
- `list_employees`: List active employees for the company. Use when the user asks about their employees, staff, team members, or headcount.
- `list_opportunities`: List sales pipeline opportunities/deals. Shows prospects, their stage, value, and next actions.
- `list_tax_rules`: List the verified tax and accounting rules AccountsOS holds for a country, with their keys and summaries: VAT or GST, company tax, income tax, payroll and deadl
- `lookup_company`: Look up a UK company on Companies House: search by name to find candidates, or fetch one by its number for the public record, its directors and its filing dates
- `lookup_tax_rule`: Look up a verified tax or accounting rule by its key, for any of the 32 countries AccountsOS covers. Needs no account: pass country. Call list_tax_rules first t
- `month_close_summary`: Composite read returning everything needed to close a month in one call: P&L for the period, balance-sheet snapshot at period end, VAT summary if registered, un
- `read_company_wiki`: Read a page from this company's private memory wiki — Finn's long-term per-company notes (preferences, decisions, people, recurring Q&A). Call with slug="index"
- `read_wiki`: Read a page from Finn's knowledge base — compiled UK (and US) tax and accounting guidance: rules, cross-references, edge cases, plain-English advice for company
- `recall_conversations`: Recall what you and the user discussed in PAST conversations (across earlier sessions, including voice and video calls). Call this whenever the user asks "what 
- `search_company_wiki`: Search this company's private memory wiki by keyword. Returns matching page slugs, titles and excerpts.
- `search_documents`: Search uploaded documents (receipts, invoices). Can also list documents by status without a query — status ["pending", "error"] is the Incoming queue. Called wi
- `search_tax_facts`: Search UK tax knowledge by keyword when unsure which category/item to look up. Returns matching tax facts across all categories.
- `search_wiki`: Search Finn's knowledge base by keyword. Returns matching page names and excerpts. Use when unsure which page covers a topic.
- `update_company`: Save the user's answers about their own business to their AccountsOS company: what kind of business it is (entity_type, for example sole_trader or ltd), the cou
- `update_transaction`: Update category, notes, or reconciliation status

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
