runBqlQuery
残高、取引、勘定科目に対して BQL（Beancount Query Language）クエリを実行します。
Model Context Protocol
会話の中に、あなたの元帳を。
いつも使っているAIツールにBeancountを接続。お金のことを質問し、元帳ファイルを編集し、変更の履歴はGitでたどれます。
ただ尋ねるだけ
まずは質問してみましょう。答えの根拠を、元帳までたどれます。
答えの根拠
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
MCP互換クライアントで動作
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
すでに使っているクライアントを接続
クライアントを選択し、サーバーを一度追加して、アクセスを許可する台帳を承認します。
Claude Code
ターミナルでこのコマンドを実行してください。
Claude Code を開き、/mcp を実行して認証します。Web Beancount にサインインし、1つの台帳またはすべての台帳を承認します。
一度承認すると、資格情報はここから自動的に更新されます。
ターミナル
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp台帳が複数ありますか？一度にすべてを承認できます。アシスタントは listLedgers を呼び出してアクセス可能な台帳を確認し、各呼び出しで台帳名を指定するため、1つのサーバーですべての帳簿をカバーできます。
Web Beancount アカウントを使用して、サーバーがアクセスできる台帳を承認します。
Web Beancountアカウントをお持ちでないですか？ beancount.ioでサインアップ — 台帳はgit push一つで完了です。
AI ができること
サーバーは、Ledger、APIキー、銀行接続に特化したツールを公開しています。Ledgerの動詞は以下に示されています。AIがそれらを組み合わせます: ファイル構造の探索、文脈のための読み取り、回答のためのクエリ、編集の提案。
Ledger、APIキー、銀行ツール。それらの使い方はお使いのクライアントが決定します。
listLedgerFiles
台帳リポジトリのディレクトリ構造を閲覧します。
readLedgerFiles
.beancount ファイルやその他の台帳ドキュメントの内容を読み取ります。
editLedgerFiles
アトミックな git コミットでファイルを作成、更新、置換、または削除します。
あなたの台帳を守ります
あなたの帳簿への書き込みアクセスを持つAIは、約束ではなく設計によって信頼を勝ち取ります。
スコープ付き OAuth 2.1
接続がアクセスできる範囲を選択できます。単一の台帳、またはすべての台帳です。個人の台帳のみを承認すれば、その接続はビジネスの帳簿に触れることはできません。影響範囲はあなたが設定します。
ドライランによるプレビュー
editLedgerFilesはdry_runモードに対応しており、何も書き込まずに正確な変更を検証・プレビューできるため、クライアントは先に差分を表示できます。
すべての編集はgitコミット
変更は実際のコミット（"AI edit: …"）として台帳のリポジトリに記録されます。標準的なgitツールで確認・取り消しできる完全な監査証跡です。
ステートレスサーバー
MCPサーバーは、ツール呼び出し間でセッション状態を保持しません。選択した AI クライアントとモデルは、リクエストした結果を受け取ります。接続前に、それらのデータポリシーを確認してください。
あなたの台帳全体はすでにgitリポジトリです。
Git for Beancountの動作を確認するMCPとは何か、Beancountにとってなぜ重要なのか？
MCP（Model Context Protocol）は、AIアシスタントが外部ツールやデータソースに構造化された安全な方法でアクセスできるようにするオープン標準です。推測したりデータを貼り付けるよう求めたりする代わりに、AIクライアントは台帳に直接接続し、実際のデータをクエリし、実際のファイルを読み取り、正確な編集を行います。
Beancount MCPサーバーと連携できるAIクライアントは？
OAuth 2.1に対応したMCP互換クライアントなら、Claude Code、Claude Desktop、Cursor、Windsurf、Zedなど、すぐにそのまま使えます。OAuth 2.1に対応していないクライアントは、beancount.ioのアカウント設定で生成した静的トークンを使って接続できます。
元帳を接続するにはどうすればいいですか？
クライアントの MCP 設定にサーバー URL を追加します。初回使用時にクライアントがブラウザウィンドウを開きます。Web Beancount アカウントでログインし、単一の台帳またはすべての台帳へのアクセスを許可するかを選択します。以降、クライアントは認証情報を自動的に保存および更新します。
AIは元帳で実際に何ができるのですか？
サーバーは特化したツール群を公開しています。beancount.io/.well-known/ にある機械可読なディスカバリーマニフェストに現在のセットがリストされています。LedgerツールはBeancount Query Languageのクエリを実行したり(runBqlQuery)、リポジトリを閲覧したり(listLedgerFiles)、Ledger文書を読み取ったり(readLedgerFiles)、そして原子的なgitコミットでファイルを作成・更新・削除したりします(editLedgerFiles、dry_runプレビューモードあり)。さらに、APIキーを管理するツール(一覧、発行、失効 — 発行には有料プランとOAuth付与が必要で、APIキーではありません)や、銀行接続とインポートを管理するツール(取引のステージング、送信、破棄 — 新しい銀行はブラウザでリンクされ、MCP経由ではありません)があります。AIはこれらを組み合わせて質問に答え、編集を提案します。
AIが私の知らないうちに元帳を変更することはありますか？
編集はeditLedgerFilesツールを通じて行われます。dry_runモードでは、何もコミットせずに計画されたファイル操作をプレビューできます。実際のコミットの前にクライアントが確認を求めるかどうかは、クライアントに依存します。コミットされたすべての変更は実際のgitコミットとして記録され、標準のgitツールで元に戻せる完全な監査証跡となります。コミットパスは書き込み後に検証エラーを報告することがあるため、まずプレビューし、その後にLedgerを検証してください。
データが第三者に送信されることはありますか？
元帳データは Web Beancount バックエンドを経由し、ツール結果として AI クライアントに返されます。選択した AI モデルがその結果を受け取るため、プロバイダーのデータポリシーも適用されます。各承認セッションは1つの元帳に限定されます。