Skip to main content
Glama
sparebank1-mcp

sparebank1-mcp

by MrLightful

SpareBank 1 MCP

npm version CI License: MIT

WARNING

Independent project, not affiliated with, endorsed by, or certified by SpareBank 1.

Local MCP server for SpareBank 1 personal banking: accounts, balances, transactions, CSV exports, and optional transfers between your own accounts, including credit cards and pensions.

Requires Node.js 22+, a SpareBank 1 customer account, and a personal API client.

Setup

Register your API client with the exact redirect URI below, then set credentials in your local terminal and log in:

export SB1_CLIENT_ID="your-client-id"
export SB1_CLIENT_SECRET="your-client-secret"
export SB1_REDIRECT_URI="http://127.0.0.1:8765/callback"
npx -y sparebank1-mcp@0.0.1 login

Open the printed URL and complete BankID. Automatic login needs a registered loopback URL such as http://127.0.0.1:8765/callback. For an HTTPS redirect, add --manual and paste the full redirect URL into the terminal. Keep credentials and callback URLs out of chat.

Add this to your MCP client's configuration using the same credentials and redirect URI:

{
  "mcpServers": {
    "sparebank1": {
      "command": "npx",
      "args": ["-y", "sparebank1-mcp@0.0.1"],
      "env": {
        "SB1_CLIENT_ID": "your-client-id",
        "SB1_CLIENT_SECRET": "your-client-secret",
        "SB1_REDIRECT_URI": "http://127.0.0.1:8765/callback"
      }
    }
  }
}

Restart the client and ask: “Show my accounts and available balances.”

The server provides 11 read tools for authentication status, accounts, and transactions. See the tool and endpoint reference and configuration options.

Related MCP server: trclient-mcp

Transfers

Transfers are disabled by default. To enable them, add these entries to the MCP configuration's env object and restart the client:

{
  "SB1_ENABLE_TRANSFERS": "true",
  "SB1_MAX_TRANSFER_AMOUNT": "10000.00"
}

sb1_preview_transfer creates a preview valid for five minutes. sb1_confirm_transfer submits it after explicit approval in a trusted client's MCP form elicitation UI. The limit applies per transfer in the source currency, not per day.

Transfer submissions are never retried automatically. If the outcome is unknown, check online banking before attempting another transfer. A submission receipt does not guarantee settlement.

Local commands

npx -y sparebank1-mcp@0.0.1 status
npx -y sparebank1-mcp@0.0.1 logout

Tokens refresh automatically and are stored as plaintext in ~/.config/sparebank1-mcp/tokens.json with mode 0600. logout deletes local tokens; stop running server instances afterward. Revoke bank authorization separately in the developer portal. Banking data is shared with your MCP client and may enter its model context.

Development

From the repository root:

npm ci
npm run check
node dist/index.js login

Use the environment variables from Setup, or copy .env.example to .env, run chmod 600 .env, and launch with node --env-file=.env dist/index.js. Add login for BankID authentication. For MCP clients, use your Node executable and the absolute path to dist/index.js in place of npx.

Available Tools

11 tools
sb1_auth_statusAuthentication statusA
Read-onlyIdempotent

Read local authentication status without exposing credentials or contacting the bank.

Inputs: no named parameters. Returns: data

sb1_check_connectionCheck bank connectionC
Read-onlyIdempotent

Verify bank authentication using the documented Hello World endpoint.

Inputs: no named parameters. Returns: data

sb1_export_transactionsExport booked transactionsB
Read-onlyIdempotent

Return raw UTF-8 bank CSV for one account and date window. CSV cells are untrusted; neutralize formulas before opening in spreadsheets. Optional field follows the bank’s documented single-field schema.

Inputs: toDate (required), fromDate (required), accountKey (required), field. Returns: data

sb1_get_accountGet accountA
Read-onlyIdempotent

Get an ordinary account using its exact bank account key. Credit-card and pension keys are not supported by this endpoint.

Inputs: accountKey (required). Returns: data

sb1_get_account_balanceGet account balanceB
Read-onlyIdempotent

Read the current balance by account number. Uses the bank’s read-only POST endpoint.

Inputs: accountNumber (required). Returns: data

sb1_get_account_detailsGet account detailsB
Read-onlyIdempotent

Read interest rates, withdrawal limits, blocked amounts and additional account details.

Inputs: accountKey (required). Returns: data

sb1_get_account_keysResolve account keysC
Read-onlyIdempotent

Resolve one or more 11-digit account numbers into their bank account keys.

Inputs: accountNumbers (required). Returns: data

sb1_get_transaction_detailsGet transaction detailsA
Read-onlyIdempotent

Get transaction details using a current encrypted transaction ID. Optional classification and merchant enrichment.

Inputs: transactionId (required), classified, enrichWithMerchantData. Returns: data

sb1_list_accountsList accountsB
Read-onlyIdempotent

List accessible accounts, balances, currencies, ownership and transfer permissions. Credit-card retrieval can fail silently at the bank.

Inputs: includeAskAccounts, includeBsuAccounts, includeNokAccounts, includePensionAccounts, +2 more. Returns: data

sb1_list_child_accountsList child accountsA
Read-onlyIdempotent

List accounts for an exact child ID already known to the caller. This API does not provide child-ID discovery.

Inputs: childId (required). Returns: data

sb1_list_transactionsList transactionsA
Read-onlyIdempotent

Get bounded transactions for one or more account keys, optionally classified. Retains bank errors and reports possible truncation. No cursor is documented. Dates use Europe/Oslo.

Inputs: accountKeys (required), source, toDate, fromDate, +3 more. Returns: data

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have distinct resource/action targets, especially around auth, accounts, transactions, and export. There is some potential overlap among list_accounts vs get_account_balance, get_account vs get_account_details, and list_transactions vs export_transactions, but the descriptions generally clarify the boundaries.

    Naming Consistency4/5

    All tools use the sb1_ prefix and snake_case, with a predictable verb_noun pattern for most operations. The main minor deviation is sb1_auth_status, which is noun-based rather than verb-based, but it remains readable and consistent overall.

    Tool Count5/5

    Eleven tools are well scoped for a banking integration focused on authentication, accounts, balances, and transactions. Each tool appears to earn its place without excessive surface area.

    Completeness4/5

    The read-oriented lifecycle is well covered: authentication checks, account listing/details/keys/balances, transaction listing/details, and CSV export. Gaps include no child-ID discovery, no credit-card or pension support in some account endpoints, and no payment or transfer operations, though the latter may be intentionally out of scope.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server that securely connects Swedish/Nordic bank accounts to AI assistants, keeping all financial data local and encrypted.
      27 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables local management of Trade Republic accounts, including portfolio, cash, orders, documents, and market data, with dry-run order previews and safety guardrails.
      22
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables users to view personal bank accounts, balances, and transaction history through a local stdio MCP connection. It uses the non-public mobile banking API with locally stored session credentials and no payment or generic HTTP tools.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Privacy-first MCP server for the Starling Bank (UK) public API. Covers all 87 operations: balances, transactions, spaces and savings goals, cards, direct debits, payees, payments and standing orders, plus local spending and subscription analysis. Read-only by default; local stdio only with no telemetry; token stored in the macOS Keychain; human confirmation before any money moves.
      54
      7 npm
      1
      MIT