Back to Browse

Accountsos MCP Server

Developer ToolsModerate6.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

6.8
Moderate6.8Moderate Risk

AccountsOS MCP server is well-structured with proper authentication and reasonable code quality. The server requires API key authentication via environment variables, has appropriate input validation, and lacks dangerous patterns. Permissions are narrowly scoped to HTTP API calls with the backend service, which is appropriate for the server's purpose. Minor code quality observations around error handling and input sanitization do not significantly impact security. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

4 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your AccountsOS API key (from https://accounts-os.com/settings)Required

Environment variable: ACCOUNTSOS_API_KEY

Override API base URL (default https://accounts-os.com)Optional

Environment variable: ACCOUNTSOS_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-paulgosnell-accountsos-mcp": {
      "env": {
        "ACCOUNTSOS_API_KEY": "your-accountsos-api-key-here",
        "ACCOUNTSOS_BASE_URL": "your-accountsos-base-url-here"
      },
      "args": [
        "-y",
        "@thriveventurelabs/accountsos-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

License

MIT

Reviews

No reviews yet

Be the first to review this server!