quicken-mac-mcp

ClaudeにQuicken For Macの財務データへの読み取り専用アクセス権を与えるClaude Skill + MCPサーバーです。口座、取引、カテゴリ別の支出、月次の傾向、投資保有状況などについてClaudeに質問できます。

データベースは常に読み取り専用で開かれるため、Quickenデータが変更されることはありません。

SkillかMCPか — どちらが必要ですか？

このリポジトリには、同じスキーマ知識（docs/schema.md）を共有する2つの成果物が含まれています。

• Skill (plugin/skills/quicken/SKILL.md) — sqlite3 CLIを使用してQuickenのSQLiteデータベースを直接読み取る方法をClaudeに教えます。Claude Codeや、スキルを読み込めるその他のClaudeインターフェースで動作します。ネイティブモジュールのインストールやMCPサーバープロセスは不要で、SQLのみを使用します。 これが推奨される方法です。

• MCPサーバー — 8つのパッケージ化されたツール（list_accounts、query_transactions、spending_by_categoryなど）として同じSQLレシピをラップします。スキルを読み込めないClaude以外のMCPクライアント（Cursor、Cline、mcp-remoteブリッジなど）で作業する場合や、ClaudeにSQLを書かせるよりも型定義されたツールを呼び出したい場合に使用してください。

Claude Codeプラグインのインストール（claude plugin install quicken-mac-mcp）では両方がバンドルされ、スキルが優先され、MCPツールはショートカットとして利用可能になります。

Related MCP server: banktivity-mcp

要件

スキルまたはMCPのいずれを使用する場合も、Quicken For Macが開いている必要があります。Quickenはアプリが閉じている間はデータベースファイルを暗号化するため、データはQuickenが実行されている間のみ読み取り可能です。

仕組み

Quicken For Macは、ドキュメントフォルダ内の.quickenバンドル（例：~/Documents/MyFinances.quicken/data）にあるCore Data SQLiteデータベースにデータを保存します。このスキルは、そのデータベースを直接クエリする方法をClaudeに教えます。MCPサーバーは、8つのパッケージ化されたクエリをツールとして公開する薄いラッパーです。

インストール — 推奨（Claude Code、プラグイン）

claude plugin install quicken-mac-mcp

これにより、/quickenスキル（推奨パス）とMCPサーバーの両方がインストールされます。Claudeはスキルを優先し、必要に応じてMCPツールにフォールバックします。

インストール — MCPのみのパス

スキルを読み込めないClaude Code以外のクライアントを使用している場合、または型定義されたツールラッパーのみが必要な場合に使用してください。

Claude Code (MCPのみ)

claude mcp add quicken -- npx -y quicken-mac-mcp

Claude Desktop (MCPBドラッグ＆ドロップ)

最新のGitHubリリースからquicken-mac-mcp.mcpbをダウンロードし、Claude Desktopにドラッグ＆ドロップします。データベースパスの入力を求められます（または自動検出されます）。

Claude Desktop (手動JSON)

~/Library/Application Support/Claude/claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"]
    }
  }
}

Claude Desktopを再起動すると、8つのツールが利用可能なハンマーアイコンが表示されます。

カスタムデータベースパス

複数のQuickenファイルがある場合、または.quickenバンドルが~/Documentsにない場合は、QUICKEN_DB_PATH環境変数を設定してください：

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"],
      "env": {
        "QUICKEN_DB_PATH": "/path/to/YourFile.quicken/data"
      }
    }
  }
}

デフォルトでは、サーバーは~/Documents内で最も最近変更された.quickenバンドルを選択して、Quickenデータベースを自動検出します。

MCPツール

これらはMCPサーバーが公開する8つのパッケージ化されたツールです。スキルは、データベースに対して直接SQLを書くことで同じ範囲（およびそれ以上）をカバーします。plugin/skills/quicken/SKILL.mdを参照してください。

プロンプトの例

• 「口座を一覧表示して」

• 「先月、食料品にいくら使った？」

• 「2024年のカテゴリ別支出を表示して」

• 「過去1年間で月々の支出はどのように変化した？」

• 「Costcoでの100ドル以上の取引をすべて見つけて」

• 「取引数で上位10人の受取人は誰？」

• 「2024年と2025年の食費を比較して」

データベーススキーマ

Quicken For Macは、以下の主要テーブルを持つCore Dataを使用します：

日付はCore Dataエポック（2001年1月1日からの秒数）を使用します。MCPサーバーはすべての日付変換を自動的に処理します。ISO 8601形式の日付を渡すと、ISO 8601形式の日付が返されます。スキルのレシピは変換（+ 978307200）をインラインで表示するため、Claudeは直接SQLを書くことができます。

口座タイプは、CHECKING、CREDITCARD、SAVINGS、MORTGAGE、RETIREMENTIRA、ASSET、LIABILITY、LOANなどの大文字の文字列として保存されます。ツールは大文字小文字を区別せずに受け入れます。

完全なスキーマ参照（84のエンティティ、すべてのテーブル、インデックス、外部キー、およびZ_OPT楽観的ロックを含むCore Data書き込みセマンティクス）については、docs/schema.mdを参照してください。

開発

git clone https://github.com/dweekly/quicken-mac-mcp.git
cd quicken-mac-mcp
npm install
npm test          # run tests
npm run lint      # eslint
npm run format    # prettier
npm run dev       # run server locally

Docker

docker build -t quicken-mac-mcp .
docker run --rm -v ~/Documents/YourFile.quicken:/data:ro quicken-mac-mcp

貢献者

• Manish Mukherjee — CategoryTagの動的Z_ENTルックアップを修正（#4）、account_namesフィルタとインポートされた取引の日付フォールバックを追加（#5）

• Als-Pal — Quicken ↔ Amazon注文照合gistにより、メモが2つのレベル（ZTRANSACTION.ZNOTEおよびZCASHFLOWTRANSACTIONENTRY.ZNOTE）に存在することが明らかになり、docs/schema.mdに記載されているZ_OPT書き戻しセマンティクスが文書化されました。

免責事項

このプロジェクトは、独立したコミュニティ開発のオープンソースツールです。Intuitの公式製品ではなく、Intuit Inc.またはその子会社によって承認、直接提携、維持、または後援されているものではありません。「Quicken」はIntuit Inc.の登録商標です。すべての製品名および会社名は、それぞれの所有者の商標または登録商標です。それらの使用は、それらとの提携や支持を意味するものではありません。

このソフトウェアは「現状のまま」提供され、いかなる種類の保証もありません。作成者および貢献者は、その使用から生じるいかなる損害、データ損失、またはその他の問題に対しても責任を負いません。サードパーティのツールを使用する前に、必ず財務データをバックアップしてください。

ライセンス

MIT