
s-stefanov/actual-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
s-stefanov/actual-mcp — это кандидат на сервер MCP, импортированный из https://github.com/s-stefanov/actual-mcp.
Обзор
s-stefanov/actual-mcp — это кандидат на сервер MCP, импортированный из https://github.com/s-stefanov/actual-mcp.
Обзор (машинный перевод)
MCP-сервер для интеграции Actual Budget с Claude и другими помощниками LLM.
Обзор
Actual Budget MCP Server позволяет взаимодействовать с вашими личными финансовыми данными из Actual Budget с использованием естественного языка через LLM. Он отображает ваши счета, транзакции и финансовые метрики через Model Context Protocol (MCP).
Особенности
Ресурсы
- Списки счетов - Просмотрите все свои счета с их балансами
- Детали счета - Просмотр подробной информации о конкретных счетах
- История транзакций - Доступ к данным транзакций с полной детализацией
Инструменты
Управление транзакциями и счетами
get-transactions- Получение и фильтрация транзакций по счету, дате, сумме, категории или получателюcreate-transaction- Создание новой транзакции на счёте с опциональной категорией, получателем и примечаниямиupdate-transaction- Обновление существующей транзакции с новой категорией, получателем, примечанием или суммойget-accounts- Получить список всех счетов с их текущим балансом и IDbalance-history- Просмотр изменений баланса счетов со временем
Отчётность и аналитика
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
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):