いいかんじ™家計簿

出納帳に入力するだけで、裏で仕訳が自動生成。 CSV・OFX・Webページ貼り付けで銀行明細を一括取込。 AIが証憑を読み取って仕訳を提案。 確定申告に必要な控除額も自動集計。

REST API

外部プログラムから仕訳の起票・閲覧・削除、AI 証憑仕訳、レポート取得ができる REST API を提供しています。API キーまたは OAuth 2.0 Device Flow による Bearer 認証に対応。OAuth は「全権限」または「読み取り専用」で承認可能です。

• REST API リファレンス — 認証・エンドポイント・エラーコード
• 仕訳 API — 仕訳の CRUD 操作
• AI 証憑仕訳 API — 画像解析・下書き管理
• 証憑 API — 証憑一覧・画像取得・操作ログ
• レポート API — 試算表・損益計算書・月次比較・確定申告集計

MCP サーバー

いいかんじ™家計簿は MCP リモートサーバーを内蔵 しています。Claude の カスタムコネクタ等から https://your-server/mcp に接続すると、財務分析や 仕訳の起票ができます。MCP 仕様の OAuth 2.1 (動的クライアント登録 + Authorization Code + PKCE) に対応し、承認時に付与する権限を スコープ単位で絞り込めます。

• MCP サーバーの使い方 — エンドポイント・OAuth フロー・提供ツール

別リポジトリの iikanji-mcp (stdio 版) も利用できます。OAuth 読み取り専用トークンと組み合わせれば、 構造的に書き込み不可で安全です。

Python クライアント

iikanji パッケージで REST API を Python から簡単に呼び出せます。

from iikanji import KakeiboClient, JournalLine

with KakeiboClient("https://your-server.example.com", "ik_your_api_key") as client:
    result = client.create_journal(
        date="2026-02-15",
        description="スーパーで食材購入",
        lines=[
            JournalLine(account_id=12, debit=3000),
            JournalLine(account_id=1, credit=3000),
        ],
    )

• はじめに — インストールと基本的な使い方
• API リファレンス — クラス・メソッド・例外
• 使用例 — 実践的なサンプルコード

活用ガイド

• iPhone ショートカットで AI 証憑仕訳 — レシートを撮影するだけで仕訳候補を自動作成

運用ガイド

公開 SaaS / 自家ホスト運用者向け:

• 運用ガイド トップ — CLI コマンド一覧
• バックアップと復旧 — PostgreSQL ダンプ・証憑画像・整合性監査
• 監視 — ログ・容量警告・レート制限

技術スタック

• Python 3.12 / Flask 3.x / Gunicorn
• PostgreSQL 16 / SQLAlchemy 2.x / Alembic
• Bootstrap 5.3 / Chart.js / PWA
• Docker Compose

リリースノート

リリースノート — 各バージョンの変更履歴

リンク

• GitHub リポジトリ (サーバー)
• GitHub リポジトリ (Python クライアント)
• いいかんじ™ライセンス (IKL) — MIT 互換