Skip to main content
Glama

PocketSmith (read-only)

Server Details

Read-only: transactions, budgets, forecasts and insights from the PocketSmith personal finance tool.

Ownership verified
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

A3.6/5.0

Scored across 40 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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
Vendor relationship
First-party · Publisher source
Privacy policy
Not provided
Restrictions
Requires a PocketSmith account; the MCP server is included for all subscription levels. · Publisher source

Available Tools

40 tools
cash_flow_forecastA
Read-onlyIdempotent
Inspect

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_snapshotA
Read-onlyIdempotent
Inspect

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_expensesA
Read-onlyIdempotent
Inspect

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_accuracyA
Read-onlyIdempotent
Inspect

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_accountA
Read-onlyIdempotent
Inspect

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_attachmentA
Read-onlyIdempotent
Inspect

Gets an attachment by its ID. Returns the attachment's title, file name, content type, and download URL.

Inputs: id (required).

get_budgetA
Read-onlyIdempotent
Inspect

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_summaryA
Read-onlyIdempotent
Inspect

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_categoryA
Read-onlyIdempotent
Inspect

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_currencyA
Read-onlyIdempotent
Inspect

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_userA
Read-onlyIdempotent
Inspect

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_statusA
Read-onlyIdempotent
Inspect

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_eventA
Read-onlyIdempotent
Inspect

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_institutionA
Read-onlyIdempotent
Inspect

Gets a financial institution by its ID. Returns the institution's title, currency, and creation date.

Inputs: id (required).

get_transactionA
Read-onlyIdempotent
Inspect

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_accountA
Read-onlyIdempotent
Inspect

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_analysisA
Read-onlyIdempotent
Inspect

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_accountsA
Read-onlyIdempotent
Inspect

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_attachmentsA
Read-onlyIdempotent
Inspect

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_categoriesA
Read-onlyIdempotent
Inspect

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_rulesB
Read-onlyIdempotent
Inspect

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_currenciesA
Read-onlyIdempotent
Inspect

Lists all currencies supported by PocketSmith. Returns currency codes, names, and symbols.

Inputs: no named parameters.

list_eventsA
Read-onlyIdempotent
Inspect

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_institutionsA
Read-onlyIdempotent
Inspect

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_labelsA
Read-onlyIdempotent
Inspect

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_searchesA
Read-onlyIdempotent
Inspect

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_zonesA
Read-onlyIdempotent
Inspect

Lists all time zones supported by PocketSmith.

Inputs: no named parameters.

list_transaction_accountsA
Read-onlyIdempotent
Inspect

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_transactionsA
Read-onlyIdempotent
Inspect

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_reviewA
Read-onlyIdempotent
Inspect

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_forecastA
Read-onlyIdempotent
Inspect

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_comparisonA
Read-onlyIdempotent
Inspect

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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with the PocketSmith personal finance API through 43 MCP tools for managing accounts, transactions, budgets, categories, and more.
      5
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      23
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources