runBqlQuery
Voer BQL (Beancount Query Language)-query's uit op saldi, transacties en rekeningen.
Model Context Protocol
Je grootboek praat mee.
Verbind Beancount met de AI-tools die je al gebruikt. Stel vragen over je financiën, werk met je grootboekbestanden en volg elke wijziging in Git.
Vraag het gewoon
Begin met een vraag. Volg het antwoord terug naar je grootboek.
Achter het antwoord
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Werkt met je MCP-compatibele client
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Verbind de client die je al gebruikt
Kies je client, voeg de server eenmalig toe en autoriseer de grootboeken die hij mag bereiken.
Claude Code
Voer dit ene commando uit in je terminal.
Open Claude Code en voer /mcp uit om te authenticeren. Log in bij Web Beancount en keur één grootboek of alle grootboeken goed.
Keur eenmalig goed. Credentials worden vanaf hier automatisch vernieuwd.
Terminal
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpMeer dan één grootboek? Keur ze allemaal in één keer goed. De assistent roept listLedgers aan om te zien wat hij kan bereiken en noemt het grootboek bij elke aanroep, zodat één server elk boek dekt.
Gebruik je Web Beancount-account om te autoriseren welke grootboeken de server mag bereiken.
Heb je geen Web Beancount-account? Meld je aan op beancount.io — je ledger is slechts een git push verwijderd.
Wat de AI kan doen
De server biedt gerichte tools voor uw ledger en uw bankkoppelingen — de ledgerwerkwoorden ziet u hieronder. De AI combineert ze: uw bestandsstructuur verkennen, context lezen, antwoorden opvragen, een wijziging voorstellen.
Ledger- en banktools. Uw client bepaalt hoe ze worden gebruikt.
listLedgerFiles
Blader door de mappenstructuur van je ledger-repository.
readLedgerFiles
Lees de inhoud van je .beancount-bestanden en andere ledger-documenten.
updateLedgerFiles
Wijzigt bestanden in een atomaire git-commit, met een dry_run-voorbeeld; createLedgerFiles en deleteLedgerFiles voegen ze toe en verwijderen ze.
Je ledger, beveiligd
Een AI met schrijftoegang tot je boeken verdient vertrouwen door ontwerp, niet door beloften.
Scoped OAuth 2.1
Jij bepaalt wat een verbinding kan bereiken: één grootboek of alle grootboeken. Autoriseer alleen je persoonlijke grootboek en de verbinding kan je zakelijke boeken niet aanraken — jij bepaalt de impact.
Dry-run-preview
De bestandstools (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) en appendLedgerText ondersteunen een dry_run-modus die de exacte wijzigingen valideert en als voorbeeld toont zonder iets te schrijven, zodat uw client u eerst een diff kan laten zien.
Elke bewerking is een git-commit
Wijzigingen worden vastgelegd als echte commits ("AI edit: …") in de repository van uw grootboek — een volledig audittrail dat u kunt bekijken en terugdraaien met standaard git-tools.
Stateloze server
De MCP-server bewaart geen sessietoestand tussen toolaanroepen. Je gekozen AI-client en model ontvangen de resultaten die je aanvraagt; controleer hun gegevensbeleid voordat je verbinding maakt.
Uw hele grootboek is al een git-repository.
Bekijk hoe Git for Beancount werktVeelgestelde vragen
Wat je moet weten voordat je verbinding maakt.
Benieuwd hoe het is gebouwd?
Lees de engineering-FAQ op de blogOverweeg je andere boekhoud-MCP-servers?
Hoe Beancount MCP zich verhoudt tot QuickBooks, Xero en ExpensifyWat is MCP en waarom is het belangrijk voor Beancount?
MCP (Model Context Protocol) is een open standaard waarmee AI-assistenten op een gestructureerde en veilige manier externe tools en gegevensbronnen kunnen aanroepen. In plaats van te raden of u te vragen gegevens te plakken, verbindt uw AI-client zich rechtstreeks met uw grootboek — het doorzoekt uw echte gegevens, leest uw werkelijke bestanden en maakt nauwkeurige bewerkingen.
Welke AI-clients werken met de Beancount MCP-server?
Elke MCP-compatibele client die OAuth 2.1 ondersteunt, werkt direct uit de doos, inclusief Claude Code, Claude Desktop, Cursor, Windsurf en Zed. Clients zonder OAuth 2.1-ondersteuning kunnen verbinding maken met een statisch token dat wordt gegenereerd in uw beancount.io-accountinstellingen.
Hoe verbind ik mijn grootboek?
Voeg de server-URL toe aan de MCP-configuratie van je client. Bij het eerste gebruik opent de client een browservenster — log in met je Web Beancount-account en kies of hij één grootboek of alle grootboeken mag bereiken. De client slaat inloggegevens vanaf dat moment automatisch op en vernieuwt ze.
Wat kan de AI daadwerkelijk met mijn grootboek doen?
De server biedt één tool per bewerking — het machineleesbare discovery-manifest onder beancount.io/.well-known/ geeft de actuele set. Ledgertools voeren Beancount Query Language-query's uit (runBqlQuery), doorzoeken de repository (listLedgerFiles), lezen ledgerdocumenten (readLedgerFiles), voegen directieven op datumvolgorde toe (appendLedgerText) en maken, wijzigen of verwijderen bestanden in een atomaire git-commit (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, elk met een dry_run-voorbeeldmodus). Banktools halen klaargezette transacties op, importeren of verwerpen ze en beheren gekoppelde verbindingen; een gloednieuwe bank koppelt u in de browser, niet via MCP. API-sleutels en accountinstellingen blijven in de Beancount.io-webapp. De AI combineert de tools om vragen te beantwoorden en wijzigingen voor te stellen.
Kan de AI mijn grootboek wijzigen zonder dat ik het weet?
Nieuwe directieven gaan via appendLedgerText, bestandswijzigingen via de bestandstools — createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Een dry_run-modus toont de geplande wijzigingen als voorbeeld zonder iets door te voeren, en of uw client vraagt voordat er echt wordt gecommit, hangt af van de client. Elke doorgevoerde wijziging wordt een echte git-commit — een volledig auditspoor dat u met standaard git-tools kunt terugdraaien. Het commitpad kan validatiefouten pas na het schrijven melden, dus bekijk eerst het voorbeeld en controleer het ledger daarna.
Wordt mijn gegevens naar een derde partij gestuurd?
Je grootboekgegevens passeren de Web Beancount-backend en keren terug als toolresultaten naar je AI-client. Het AI-model dat je kiest ontvangt die resultaten, dus het gegevensbeleid van de provider is ook van toepassing. Een verbinding bereikt alleen de grootboeken die je hebt geautoriseerd: één grootboek of allemaal.
Breng je grootboek in je volgende gesprek.
De Beancount MCP-server is vandaag beschikbaar voor alle Web Beancount-gebruikers. Uw grootboek is één git push verwijderd.