Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

AccountsOS

by thriveventurelabsversion 0.3.2i★ 0iComputer or cloudOfficial site ↗
Registry nameio.github.paulgosnell/accountsos-mcp

How to install

What it does

Query your live AccountsOS books: balances, transactions, VAT, deadlines, invoices.

  • Connects Computer or cloud
  • Account or key Cloud: No key needed · Local: Needs ACCOUNTSOS_API_KEY
  • Category Accounting, finance & tax

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score20/100

Quality: Passed 4/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install AccountsOS. Follow https://mcp.popnx.com/i/paulgosnell-accountsos-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 4/5 checks · What you ask goes through the maker’s server (accounts-os.com) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameAccountsOS
    Remote MCP server URL · Addresshttps://accounts-os.com/api/mcp/plugin

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsAccountsOS

  4. Try it

    Use AccountsOS and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using AccountsOS or shows a AccountsOS tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameAccountsOS
    Connection · Addresshttps://accounts-os.com/api/mcp/plugin
  3. Pick AccountsOS in a chat

    Start a new chat and pick AccountsOS from your plugins before typing

  4. Try it

    Use AccountsOS and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using AccountsOS or shows a AccountsOS tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user accountsos https://accounts-os.com/api/mcp/plugin
  3. Type /mcp in Claude Code

    You should see AccountsOS listed as connected

  4. Try it

    Use AccountsOS and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using AccountsOS or shows a AccountsOS tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use AccountsOS and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using AccountsOS or shows a AccountsOS tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use AccountsOS and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using AccountsOS or shows a AccountsOS tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://accounts-os.com/api/mcp/plugin

JSON settings are under “For developers” below

Stuck? Ask people who use AccountsOS💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user accountsos https://accounts-os.com/api/mcp/plugin

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "accountsos": {
      "url": "https://accounts-os.com/api/mcp/plugin"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "accountsos": {
      "type": "http",
      "url": "https://accounts-os.com/api/mcp/plugin"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user accountsos --env ACCOUNTSOS_API_KEY=your-value -- npx -y @thriveventurelabs/accountsos-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "accountsos": {
      "command": "npx",
      "args": [
        "-y",
        "@thriveventurelabs/accountsos-mcp"
      ],
      "env": {
        "ACCOUNTSOS_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "accountsos": {
      "command": "npx",
      "args": [
        "-y",
        "@thriveventurelabs/accountsos-mcp"
      ],
      "env": {
        "ACCOUNTSOS_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "accountsos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@thriveventurelabs/accountsos-mcp"
      ],
      "env": {
        "ACCOUNTSOS_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • ACCOUNTSOS_API_KEY secret required env
    Your AccountsOS API key (from https://accounts-os.com/settings)
  • ACCOUNTSOS_BASE_URL env
    Override API base URL (default https://accounts-os.com)

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
43/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.3.2
Published to registryi
Oct 28, 2026
Code last changedi
Oct 28, 2026
Last checked
Nov 17, 2026
Maker
thriveventurelabs
Packages
npm: @thriveventurelabs/accountsos-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 17, 2026. The maker wrote them, not us; we show them as plain text.

  • 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 more than one company, then pass `company` to the other tools.

  • 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 country it is registered in (ISO code such as GB, IE, US), the company or registration number, the name, what it does, the

  • 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, directors, year-end and filing deadlines. Call it only after lookup_company found the company and the user confirmed it is t

  • 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 same way as an emailed document: a bank statement is imported into a bank account (created if it does not exist yet), a re

  • 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, whether anything is overdue or was filed late, and a score out of 100 with the reasons. Needs no account. Use it whenever

  • 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 estimate for the current UK tax year. Needs no account.

  • 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 no account.

  • 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 tax year. Needs no account.

  • 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 invoice still waiting to be paid, NOT money received: leave it out of any cash, income received or bank balance figure. Fo

  • get_balance

    Get current account balance

  • 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 does for it. reminder_only means AccountsOS does not produce the form.

  • get_vat_summary

    Get VAT summary for a calendar quarter, or for any VAT period with start_date and end_date

  • search_documents

    Search uploaded documents (receipts, invoices). Can also list documents by status without a query — status ["pending", "error"] is the Incoming queue. Called with no arguments it lists the newest uploads (up to 25).

  • 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 directors. Call with page="index" first to list all available pages.

  • search_wiki

    Search Finn's knowledge base by keyword. Returns matching page names and excerpts. Use when unsure which page covers a topic.

  • 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" first to list available pages.

  • search_company_wiki

    Search this company's private memory wiki by keyword. Returns matching page slugs, titles and excerpts.

  • get_tax_facts

    Look up current UK tax rates, thresholds and allowances (income_tax, national_insurance, corporation_tax, dividends, capital_allowances, vat, pensions, mileage, self_assessment, home_office, mtd). Returns the figure plus its source.

  • search_tax_facts

    Search UK tax knowledge by keyword when unsure which category/item to look up. Returns matching tax facts across all categories.

  • list_categories

    List available transaction categories for categorization

  • 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_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 to them.

  • get_contacts

    List contacts (clients, suppliers, leads). Use when user asks about customers, suppliers, or contacts.

  • get_bills

    Get supplier bills/invoices owed by the company. Shows what you owe to suppliers.

  • get_estimates

    Get estimates/quotes sent to clients.

  • get_profit_and_loss

    Get Profit and Loss (income statement) report for a period.

  • get_balance_sheet

    Get Balance Sheet report as at a given date.

  • get_trial_balance

    Get Trial Balance showing all account balances.

  • get_tasks

    Get tasks and to-dos for the company.

  • get_expense_claims

    Get expense claims and reimbursement requests.

  • get_bank_accounts

    List bank accounts connected to the company.

  • get_journal_entries

    Get General Ledger journal entries. Double-entry accounting records.

  • list_opportunities

    List sales pipeline opportunities/deals. Shows prospects, their stage, value, and next actions.

  • get_opportunity

    Get detailed information about a specific pipeline opportunity/deal, including notes and activity history.

  • 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 functional-currency total for the same set. Use when the user asks "total income in EUR and in GBP", "how much came in in e

  • 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 numbers on the user's Home dashboard. Use for "how am I doing", "how much am I owed", "what do I owe", "what's my position",

  • 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 rest), what's available but not connected, what is coming soon and cannot be connected yet (`coming_soon`), and whether dat

  • 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 113C), the balance owing or refund, the due date and any warnings. Defaults to the last completed reporting period. Alwa

  • 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 schedule 100 / 125'. Maps any new accounts first. AccountsOS prepares the GIFI trial balance for the accountant's T2 software

  • 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 submitted ones. Use this FIRST when the user asks about VAT returns, "which quarters are outstanding", "have I filed Q1", or

  • 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) directly from HMRC MTD. Use when the user asks "what does HMRC say I owe a return for", "when is my next VAT return due accord

  • 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", "what's outstanding on my VAT account". Requires HMRC MTD connected.

  • 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 have I paid". Requires HMRC MTD connected.

  • 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 registered" answer is a real answer from HMRC, not an error. Use this when the user asks whether a VAT number is valid, when ad

  • 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 status), plus a count of documents still processing or failed. Use whenever the user asks what is waiting in Incoming, whethe

  • 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 know the official guidance on a topic like VAT, corporation tax, dividends, or director responsibilities.

  • 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 "who owes me money", "what's in our debtors book", "show aged receivables", or wants to pick which clients to chase. Read

  • 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 "who do I owe", "what bills are due", "show aged payables", or is planning supplier payments. Read-only.

  • 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.

  • list_employees

    List active employees for the company. Use when the user asks about their employees, staff, team members, or headcount.

  • 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 is. For a salary, drawings or "what have I paid myself" question read list_employees (the configured salary), this (whet

  • get_projects

    List projects (pipeline, active, completed). Use when the user asks about their projects, deals, or pipeline.

  • 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 commitment summaries. Use for "how is project X doing", "project profit", "mini P&L for a project", and for the final report whe

  • 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 transactions. On a national chart an account marked takes_postings: false is a heading with analytic accounts under it: never

  • 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, net assets, capital and reserves), average employees, turnover and profit after tax where the filing includes a profit

  • 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, same time last year, how did last year go. Returns the completed years (from the ledger or the filed accounts), the curren

  • 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, budget variance, are we on track, or how a month, quarter or the year compares with the plan. Returns, for each income,

  • 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, what the euro to dirham or pound to dollar rate is, what a currency move cost us, or whether it is cheaper to buy in o

  • 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 for the active assets: quote those, never add the register up yourself. Use when the user asks about their asset register

  • 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 a jurisdiction note. Use when the user asks about capital allowances, AIA, or tax relief on a specific asset — not a fi

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ! Caution

    Maker matches the repo

    The publisher (paulgosnell) is not the repo owner (thriveventurelabs); someone else may have listed it

  • ✓ Pass

    Still maintained

    Code last changed 22 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 161 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 60 tool descriptions and found no hidden instructions to the AI

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for @thriveventurelabs/accountsos-mcp@0.3.1

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/paulgosnell-accountsos-mcp.svg)](https://mcp.popnx.com/en/servers/paulgosnell-accountsos-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Accounting, finance & taxi

  • More stars than 0% of the other 3423 servers in this category
  • Published to the registry more recently than 58% of the other 3423 servers in this category
  • Basic checks equal to or better than 60% of the other 3423 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is AccountsOS safe?

It passed 4 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: ACCOUNTSOS_API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 22 days ago, and the latest version (0.3.2) reached the registry 22 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

by signal8aiGrowing↓ 431/wk★ 425Updated 10 days ago

Computer or cloud✓ service owner · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

by CursivezGrowing★ 261Updated 11 days ago

Runs in the cloud✓ service owner · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

by bex-coGrowing★ 702 Stars for the whole repoUpdated 44 days ago

Runs in the cloud✓ service owner · beancount.io
Compared with similar ones
This one
AccountsOS
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Runs whereCloud or install on your computerRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyYesNoYesNoNoYes
Add with + in ClaudeNoNoNoNoNoNo
Basic checks4/54/65/54/44/45/5
LicenseMITMITMITNOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

AccountsOS MCP Server

Query your live AccountsOS ledger from any MCP client (Claude Desktop, Claude Code, Cursor) via the Model Context Protocol.

AccountsOS runs jurisdiction playbooks for 26 countries. The UK is the proof jurisdiction, with live HMRC MTD VAT filing.

npm: https://www.npmjs.com/package/@thriveventurelabs/accountsos-mcp

Installation

Option 1: Global Install (Recommended)
npm install -g @thriveventurelabs/accountsos-mcp

Then add to Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{

"mcpServers": { "accountsos": { "command": "accountsos-mcp", "args": [], "env": { "ACCOUNTSOS_API_KEY": "your-api-key-here" } } } }

Option 2: Using npx
{

"mcpServers": { "accountsos": { "command": "npx", "args": ["--yes", "@thriveventurelabs/accountsos-mcp@latest"], "env": { "ACCOUNTSOS_API_KEY": "your-api-key-here" } } } }

Get your API key from AccountsOS Settings.

Available Tools

Read Operations
ToolDescription
get_transactionsQuery transactions with filters (date, category, amount, search)
get_balanceGet current account balance(s)
get_deadlinesView upcoming tax and filing deadlines
get_vat_summaryGet VAT summary for any quarter
search_documentsSearch uploaded receipts and invoices
list_categoriesList available UK GAAP transaction categories
Write Operations
ToolDescription
create_transactionCreate a new transaction (with auto-categorization)
update_transactionUpdate category, notes, or reconciliation status
categorize_transactionGet AI-suggested category for a transaction
create_deadlineCreate a new tax/filing deadline reminder

Available Resources

ResourceDescription
accountsos://companyCompany details and settings
accountsos://transactionsMost recent 50 transactions
accountsos://documentsUploaded documents
accountsos://deadlinesUpcoming deadlines

Example Prompts

Once connected, try asking Claude:

  • "What's my account balance?"
  • "Show me transactions from last month"
  • "When is my next VAT deadline?"
  • "How much have I spent on software subscriptions?"
  • "Create a transaction for lunch with a client, £45"
  • "What's my VAT summary for Q4 2024?"

Development

# Install dependencies

npm install

Build

npm run build

Run locally (for testing)

ACCOUNTSOS_API_KEY=sk_live_xxx npm start

Environment Variables

VariableRequiredDescription
ACCOUNTSOS_API_KEYYesYour AccountsOS API key
ACCOUNTSOS_BASE_URLNoOverride API base URL (default: https://accounts-os.com)

Troubleshooting

Server disconnected

Check logs at ~/Library/Logs/Claude/mcp-server-accountsos.log

npx issues

If npx has caching issues, use global install instead:

npm install -g @thriveventurelabs/accountsos-mcp

Disclaimer

This software provides general guidance about UK tax and accounting rules. It is not a substitute for professional advice from a qualified accountant or tax adviser. Always verify with HMRC source documents and consult a professional for advice specific to your circumstances.

License

MIT