sparebank1-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sparebank1-mcp Show my accounts and available balances"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SpareBank 1 MCP
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 loginOpen 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 logoutTokens 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 loginUse 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 toolssb1_auth_statusAuthentication statusARead-onlyIdempotent
Read local authentication status without exposing credentials or contacting the bank.
Inputs: no named parameters. Returns: data
sb1_check_connectionCheck bank connectionCRead-onlyIdempotent
Verify bank authentication using the documented Hello World endpoint.
Inputs: no named parameters. Returns: data
sb1_export_transactionsExport booked transactionsBRead-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 accountARead-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 balanceBRead-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 detailsBRead-onlyIdempotent
Read interest rates, withdrawal limits, blocked amounts and additional account details.
Inputs: accountKey (required). Returns: data
sb1_get_account_keysResolve account keysCRead-onlyIdempotent
Resolve one or more 11-digit account numbers into their bank account keys.
Inputs: accountNumbers (required). Returns: data
sb1_get_transaction_detailsGet transaction detailsARead-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 accountsBRead-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 accountsARead-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 transactionsARead-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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Normalize bank statements (CSV, camt, MT940, OFX, QIF) to JSON, analyze, export.
Normalize bank statements (CSV, camt, MT940, OFX, QIF) to JSON, analyze, export.
Read-only finance MCP server. Connects your banks, cards, payment apps, books and payroll into one ledger for your AI. Can't move money. Open source (AGPL-3.0), free during beta.
Read-only access to your bank, investment, and crypto accounts: balances, transactions, holdings.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server that securely connects Swedish/Nordic bank accounts to AI assistants, keeping all financial data local and encrypted.27 npmMIT
- AlicenseAqualityBmaintenanceEnables local management of Trade Republic accounts, including portfolio, cash, orders, documents, and market data, with dry-run order previews and safety guardrails.221MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseBqualityBmaintenancePrivacy-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.547 npm1MIT