
s-stefanov/actual-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
s-stefanov/actual-mcp は、https://github.com/s-stefanov/actual-mcp. からインポートされたMCPサーバー候補です。
概要
s-stefanov/actual-mcp は、https://github.com/s-stefanov/actual-mcp. からインポートされたMCPサーバー候補です。
概要(AI 翻訳)
Actual BudgetをClaudeや他のLLMアシスタントと統合するためのMCPサーバー。
概要
Actual Budget MCPサーバーは、LLMを通じて自然言語を使って実際の予算の個人財務データとやり取りできるようにします。モデルコンテキストプロトコル(MCP)を通じて、あなたの口座、取引、財務指標を公開します。
特徴
リソース
- アカウントリスト - すべてのアカウントとその残高を閲覧
- アカウント詳細 - 特定のアカウントの詳細情報を閲覧
- 取引履歴 - 取引データの詳細にアクセスできる
道具
取引およびアカウント管理
get-transactions- 取引をアカウント、日付、金額、カテゴリ、または受取人で取得・フィルタリングcreate-transaction- オプションカテゴリ、受取人、ノートを使ったアカウント内で新しい取引を作成するupdate-transaction- 既存の取引を新しいカテゴリ、受取人、ノート、または金額で更新するget-accounts- すべての口座の現在の残高とIDのリストを取得するbalance-history- アカウント残高の時間経過による変動を見る
レポーティング&アナリティクス
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
Actual Budget MCP Server
MCP server for integrating Actual Budget with Claude and other LLM assistants.
Overview
The Actual Budget MCP Server allows you to interact with your personal financial data from Actual Budget using natural language through LLMs. It exposes your accounts, transactions, and financial metrics through the Model Context Protocol (MCP).
Features
Resources
- Account Listings - Browse all your accounts with their balances
- Account Details - View detailed information about specific accounts
- Transaction History - Access transaction data with complete details
Tools
Transaction & Account Management
get-transactions- Retrieve and filter transactions by account, date, amount, category, or payeecreate-transaction- Create a new transaction in an account with optional category, payee, and notesupdate-transaction- Update an existing transaction with new category, payee, notes, or amountget-accounts- Retrieve a list of all accounts with their current balance and IDbalance-history- View account balance changes over time
Reporting & Analytics
spending-by-category- Generate spending breakdowns categorized by typemonthly-summary- Get monthly income, expenses, and savings metricsbudget-vs-actual- Compare budgeted amounts against actual spending per categorynet-worth- Track assets, liabilities, and net worth across all accounts over timecategory-trends- See how spending in each category moves month over month, with trend directionspending-by-payee- Rank payees by how much was spent with (or received from) each onecash-flow- Report income, expenses, and net cash flow per month or week
The five tools above return JSON rather than markdown, so amounts stay machine-readable. Every amount is an integer number of cents, and each response carries an
amountsInfield describing the sign conventions it uses.
Custom Reports & Dashboards
get-custom-reports- Retrieve every saved custom report from the Reports sectioncreate-custom-report- Create a saved custom reportupdate-custom-report- Update fields on a saved custom report, leaving the rest unchangeddelete-custom-report- Delete a saved custom reportget-dashboards- Retrieve every dashboard page and the widgets laid out on itadd-dashboard-widget- Add a widget to a dashboard pageupdate-dashboard-widget- Update a widget’s configuration, position, or sizeremove-dashboard-widget- Remove a widget from its pageorganize-dashboard- Reposition and resize several widgets at oncecreate-dashboard-page/rename-dashboard-page/delete-dashboard-page- Manage dashboard pages
Categories
get-grouped-categories- Retrieve a list of all category groups with their categories
インストール
npx -y actual-mcp --enable-write設定
{
"mcpServers": {
"actualBudget": {
"command": "npx",
"args": ["-y", "actual-mcp", "--enable-write"],
"env": {
"ACTUAL_DATA_DIR": "path/to/your/data",
"ACTUAL_PASSWORD": "your-password",
"ACTUAL_SERVER_URL": "http://your-actual-server.com",
"ACTUAL_BUDGET_SYNC_ID": "your-budget-id"
}
}
}
}
### a. Using Node.js (local only):