PocketSmith (read-only)
Server Details
Read-only: transactions, budgets, forecasts and insights from the PocketSmith personal finance tool.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- PocketSmith Read-Only Access
TDQS
Scored across 40 tools
Descriptions do heavy lifting with explicit cross-references ('for X use Y instead'), so most report tools have a clearly signposted role. There is residual overlap between financial_health_snapshot / month_end_review / spending_comparison, and between get_budget / get_budget_summary / navigate_to_budget, plus a near-parallel data tool for every navigate_to_* link, which forces the agent to pick a pair before picking a tool.
Two clearly grouped conventions: verb_noun CRUD-ish getters/listers (list_accounts, get_transaction, list_transactions) and noun-phrase analysis endpoints (cash_flow_forecast, month_end_review, spending_comparison), plus a uniform navigate_to_<page> family. The split is readable and predictable, though 'find_recurring_expenses' and 'get_trend_analysis' vs 'navigate_to_trends' show minor drift.
40 tools is well past the comfortable range, and roughly 8 are navigation deep-links that pair one-to-one with data tools, effectively doubling the surface for the same question. Several analytical endpoints (three period-review tools, three budget tools) could be consolidated without losing capability.
The read-only surface is broad: accounts, transactions, categories, labels, rules, events, budgets, trends, forecasts, net worth, feeds, currencies, time zones, attachments and saved searches. Gaps are modest but real — scenarios are referenced by many tools (list_events, list_transactions) yet there is no list_scenarios/get_scenario, and single-item getters are missing for labels and category rules.
Publisher details
- Operator
- PocketSmith Ltd · Publisher source
- Operator website
- https://www.pocketsmith.com
- Vendor relationship
- First-party · Publisher source
- Documentation
- https://www.pocketsmith.com/mcp
- Privacy policy
- Not provided
- Trust center
- https://www.pocketsmith.com/security/
- Restrictions
- Requires a PocketSmith account; the MCP server is included for all subscription levels. · Publisher source
Available Tools
40 toolscash_flow_forecastARead-onlyIdempotentInspect
Forward-looking account-level balance projections using PocketSmith's forecasting engine. Shows where each account is heading and identifies danger zones where balances drop below a configurable threshold. Filter by account types (bank, cash, credits, stocks, mortgage, loans, retirement) or specific account IDs. Accounts without linked scenarios will have no forecast data. Credit cards naturally have negative balances — adjust danger_threshold accordingly when checking credit accounts. The forecast horizon is limited only by the user's subscription plan date limits — multi-year projections (e.g. loan payoff dates) are fine; use monthly resolution for long horizons. navigate_to_cashflows is the matching page link to offer alongside any projection answer.
Inputs: user_id, resolution, account_ids, months_ahead, +2 more.
financial_health_snapshotARead-onlyIdempotentInspect
Point-in-time financial health check. Returns net worth, cash position (liquid accounts), current month spending pace with projection and last-month comparison, per-category budget traffic lights (on_track/at_risk/over_budget) with each category tagged is_bill to distinguish bills from discretionary budgets, action items (uncategorized and needs-review counts), and upcoming events in the next 14 days split into bills and budget events. Ideal for a quick daily or weekly check-in or a broad 'how am I doing financially' RIGHT NOW. For a one-period retrospective use month_end_review; to compare two periods use spending_comparison; for just the upcoming events list use list_events.
Inputs: user_id.
find_recurring_expensesARead-onlyIdempotentInspect
Detects recurring expenses (subscriptions, memberships, regular bills) by analyzing transaction history. Groups transactions by payee, identifies regular intervals and consistent amounts, and classifies frequency (weekly, monthly, quarterly, etc.). Returns estimated annual cost per item and totals. Useful for subscription audits, finding forgotten recurring charges, and 'am I paying too much for X' policy/premium comparisons. No report page maps to subscriptions — answer from this data directly rather than offering a navigation link.
Inputs: months, user_id.
forecast_accuracyARead-onlyIdempotentInspect
Compares actual vs forecast account balances over a past period to evaluate how reliable the user's forecasting has been. Also analyses budget data to identify inaccuracy drivers — categories that are unbudgeted (spending with no budget), significantly underbudgeted (actual exceeds forecast by 25%+), or significantly overbudgeted (forecast exceeds actual by 2x+). Note: forecast values for past dates reflect the CURRENT scenario settings, not what was originally forecast. This is useful for calibrating current forecast configuration. Accounts without linked scenarios will have no forecast data for comparison.
Inputs: user_id, resolution, account_ids, months_back.
get_accountARead-onlyIdempotentInspect
Gets an account by its ID. An account is a container that groups one or more transaction accounts (where transactions live) and scenarios (where budget forecasts live). Most accounts have a single transaction account, but some (e.g. a mortgage with offset) have multiple. Returns the account's title, type, currency, current balance, and its child transaction accounts and scenarios.
Inputs: id (required).
get_attachmentARead-onlyIdempotentInspect
Gets an attachment by its ID. Returns the attachment's title, file name, content type, and download URL.
Inputs: id (required).
get_budgetARead-onlyIdempotentInspect
Gets the user's budget for their configured forecast period — one entry per category with budgeted vs actual figures, the data behind the Budget page's per-category list. Optionally rolls up child categories into their parents. Use get_budget_summary for analysis over a specific date range; navigate_to_budget is the matching page link to offer alongside an answer.
Inputs: user_id (required), roll_up.
get_budget_summaryARead-onlyIdempotentInspect
Gets the user's budget summary with expense and income analysis across all categories (excluding transfers) for a given date range and period. Returns actual vs budgeted figures per period bucket — the only analysis tool with sub-monthly buckets (weekly, or fortnightly via period=weeks interval=2), so use it for pay-cycle asks like 'what's left over each fortnight'. navigate_to_budget (manage) or navigate_to_income_expense (statement) is the matching page link to offer alongside an answer.
Inputs: period (required), user_id (required), end_date (required), interval (required), +1 more.
get_categoryARead-onlyIdempotentInspect
Gets a category by its ID. Returns the category's title, colour, parent category (if any), and whether it is a transfer or bill category.
Inputs: id (required).
get_currencyARead-onlyIdempotentInspect
Gets a specific currency by its code (e.g. 'nzd', 'usd'). Returns the currency's name, symbol, and decimal places.
Inputs: id (required).
get_current_userARead-onlyIdempotentInspect
Gets the currently authenticated PocketSmith user. Returns the user's ID, name, email, time zone, currency, and account metadata. Use this to obtain the user ID needed by most other tools.
Inputs: no named parameters.
get_data_feeds_connection_statusARead-onlyIdempotentInspect
Lists all data feed connections for a user with their sync status, including last successful sync time, next sync time, and provider details. Optionally includes per-connection account details (balances, transaction update times). Use this to check if feeds are healthy, degraded, or need attention.
Inputs: user_id (required), include_accounts.
get_eventARead-onlyIdempotentInspect
Gets a budget event by its ID. Events represent recurring or one-off income/expense entries used in budget forecasting. The ID format is 'number-timestamp' (e.g. '42-1601942400').
Inputs: id (required).
get_institutionARead-onlyIdempotentInspect
Gets a financial institution by its ID. Returns the institution's title, currency, and creation date.
Inputs: id (required).
get_transactionARead-onlyIdempotentInspect
Gets a single transaction by its ID. Returns the transaction's date, payee, amount, category, labels, note, memo, and review status.
Inputs: id (required).
get_transaction_accountARead-onlyIdempotentInspect
Gets a transaction account by its ID. A transaction account is where transactions are recorded. It belongs to a parent account (container) and optionally links to an institution. Each account has one or more transaction accounts. Returns the account name, number, type, currency, current balance, and starting balance.
Inputs: id (required).
get_trend_analysisARead-onlyIdempotentInspect
Gets income and/or expense budget trend analysis for a date range and period — the data behind the Trends report (per-bucket actual vs budget for chosen categories over time). Analyses across specified categories and all user scenarios by default. navigate_to_trends is the matching page link to offer alongside an answer.
Inputs: period (required), user_id (required), end_date (required), interval (required), +3 more.
list_accountsARead-onlyIdempotentInspect
Lists accounts. Requires either user_id or institution_id. Each account is a container grouping one or more transaction accounts (where transactions live) and scenarios (where budget forecasts live). Use get_current_user for user IDs, list_institutions for institution IDs.
Inputs: user_id, institution_id.
list_attachmentsARead-onlyIdempotentInspect
Lists attachments. Requires either user_id or transaction_id. When filtering by user, optionally return only unassigned attachments.
Inputs: user_id, unassigned, transaction_id.
list_categoriesARead-onlyIdempotentInspect
Lists all categories belonging to a user. Categories are hierarchical - each category may have a parent and children. Returns each category's ID, title, colour, type, and parent relationship.
Inputs: user_id (required).
list_category_rulesBRead-onlyIdempotentInspect
Lists all category rules belonging to a user. Category rules automatically assign categories to transactions based on payee matching patterns.
Inputs: user_id (required).
list_currenciesARead-onlyIdempotentInspect
Lists all currencies supported by PocketSmith. Returns currency codes, names, and symbols.
Inputs: no named parameters.
list_eventsARead-onlyIdempotentInspect
Lists budget events within a date range. Requires either user_id or scenario_id. Events represent recurring or one-off income/expense entries used in budget forecasting. A scenario belongs to an account and contains the events that drive its forecast.
Inputs: end_date (required), start_date (required), user_id, scenario_id.
list_institutionsARead-onlyIdempotentInspect
Lists all financial institutions belonging to a user. Each institution represents a bank or financial provider and contains one or more accounts.
Inputs: user_id (required).
list_labelsARead-onlyIdempotentInspect
Lists all labels belonging to a user. Labels are free-form tags that track things ACROSS categories — commonly tax-deductible, reimbursable, or per-project expenses — so check here when a 'pull together my work expenses' style ask has no matching category (list_transactions search matches label text). Labels are created implicitly when first added to a transaction via create_transaction or update_transaction.
Inputs: user_id (required).
list_saved_searchesARead-onlyIdempotentInspect
Lists saved searches belonging to a user. Saved searches are pre-configured transaction filters. They cannot be executed via the API - use the returned filter criteria with list_transactions manually, or open one in the app by passing its numeric ID as the token to navigate_to_transactions.
Inputs: user_id (required).
list_time_zonesARead-onlyIdempotentInspect
Lists all time zones supported by PocketSmith.
Inputs: no named parameters.
list_transaction_accountsARead-onlyIdempotentInspect
Lists all transaction accounts for a user. Transaction accounts hold the actual transactions. Each belongs to a parent account (container). Use get_current_user to obtain the user ID.
Inputs: user_id (required).
list_transactionsARead-onlyIdempotentInspect
Lists transactions with pagination (default 30/page, max 100). Requires at least one of user_id, account_id, category_id, or transaction_account_id. Supports date range, type, category status, review status, and keyword search. Search terms are space-separated and ANDed: each word is substring-matched across date, amount, account name, payee, category title, note and labels, so multi-word queries refine accurately (e.g. 'epartner 36' = payee fragment + amount fragment; 'epartner 3d' = payee + label). Every word must literally appear in some field though — filler words like 'refund' or 'reimbursement' match nothing unless they're in the payee/note. The richer in-app search (duplicate/transfer specials, saved searches, category-scoped tokens) is not available via the API — offer navigate_to_transactions for those. Use get_current_user for user IDs, list_accounts for account IDs, list_categories for category IDs, list_transaction_accounts for transaction account IDs.
Inputs: page, type, search, user_id, +9 more.
month_end_reviewARead-onlyIdempotentInspect
Comprehensive financial review for any date range. Returns income/expense summary with prior-period comparison, savings rate, per-category budget variance (each category tagged with is_bill to distinguish bills from discretionary budgets), top payees, notable transactions, net worth snapshot, upcoming obligations split into bills and budget events, and housekeeping counts. Ideal for a retrospective on ONE period — monthly reviews, quarterly check-ins, 'where did my money go last month'. To compare TWO periods use spending_comparison; for a right-now health check use financial_health_snapshot. The output is structured for easy summarization and sharing with household members. navigate_to_income_expense is the matching page link to offer alongside an answer.
Inputs: user_id, end_date, start_date.
net_worth_forecastARead-onlyIdempotentInspect
Projects net worth trajectory spanning past history and future forecast. Returns historical trend, forecast projection, growth metrics, and milestone projections (auto-detected or user-specified). Uses the user-level balances endpoint which aggregates ALL accounts (not just those marked is_net_worth). Growth metrics use simple average monthly change (not CAGR) to handle net worth crossing zero correctly. Milestones apply to TOTAL net worth only — for a single account reaching a target balance (e.g. an emergency fund hitting $10k) use cash_flow_forecast with account_ids instead. Subscription plan limits may restrict the available date range. navigate_to_net_worth is the matching page link to offer alongside an answer.
Inputs: user_id, milestones, resolution, months_back, +1 more.
spending_comparisonARead-onlyIdempotentInspect
Compares spending between two date periods. Returns overall totals, per-category breakdown, per-payee breakdown, and highlights new/disappeared payees between periods. Optionally filter to specific categories. Excludes transfers. Useful for month-over-month, year-over-year, or any custom period comparison ('am I spending more on X than last year'). For a single period's breakdown use month_end_review; for a right-now check use financial_health_snapshot. navigate_to_trends is the matching page link to offer alongside a comparison answer.
Inputs: period_a_end (required), period_b_end (required), period_a_start (required), period_b_start (required), +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Work with transactions, budgets, forecasts and insights from the PocketSmith personal finance tool.
Read-only Fillfolio portfolios, holdings, cash, liabilities, activity, spending and budgets.
Multi-currency budgeting: read and update your accounts, transactions, categories and budgets.
Read-only cash flow, spending, subscriptions and transaction search from your US and Canadian banks.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables interaction with the PocketSmith personal finance API through 43 MCP tools for managing accounts, transactions, budgets, categories, and more.5MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with the Pocketsmith personal finance API to manage accounts, budgets, and transactions through natural language. It supports comprehensive financial tasks including spending analysis, category management, and tracking recurring bills.233MIT
- AlicenseAqualityCmaintenanceEnables read-only access to YNAB budgets, accounts, categories, payees, and transactions, plus safe addition of unapproved transactions with dry-run and duplicate pre-check for reconciliation workflows.6MIT
- AlicenseNot gradedqualityCmaintenanceProvides read-only access to self-hosted cash-flow forecasts, balances, transactions, and credit-card data, letting AI clients answer spending and upcoming-obligation questions without modifying financial settings.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.