PocketSmith
PocketSmith is a personal finance platform for tracking accounts and transactions, managing budgets, and forecasting financial outcomes.
Verdict
Common use cases
- Reconcile monthly expenses from Slack threads
- Compare forecast vs actual spend by category
- Log receipts as transactions during travel
- Analyze budget performance at quarter end
- Create budget categories from planning docs
Integration
- Vendor
- PocketSmith
- Category
- finance
- Auth
- API_KEY
- Tools
- 14
- Composio slug
pocketsmith
Tools
- Create Category
Create one category for a PocketSmith user with optional hierarchy and budgeting behavior.
- Create Transaction
Create one transaction in a specified transaction account and return the created financial record.
- Get Budget
Return a PocketSmith user's current category-level actual and forecast budget analysis. During probing, this read coincided with forecast cache access/update timestamps changing to the call timestamp and the forecast start date also changin
- Get Budget Summary
Analyze the user's combined income and expense budget over a required date range and period interval.
- Get Current User
Return the PocketSmith user authorized by the connected developer key, including the user ID needed by user-scoped tools.
- Get Transaction
Return one PocketSmith transaction by ID with its amount, date, payee, category, labels, and review state.
- List Accounts
Return all financial accounts belonging to a PocketSmith user, including account, primary transaction-account, and scenario IDs.
- List Categories
Return all categories belonging to a PocketSmith user, including hierarchy and budgeting flags.
- List Transaction Accounts
Return the transaction accounts belonging to a PocketSmith user, including IDs and balances needed to create and query transactions.
- List Transactions
Return one page of a user's transactions with optional date, state, type, and keyword filters, plus a cursor for the next page.
- Update Account
Update selected metadata on one financial account without deleting it or changing transaction-account balances.
- Update Category
Update selected hierarchy, display, and budgeting fields on one category without deleting it.
- Update Transaction
Update selected fields on one existing transaction without deleting or splitting it.
- Update Transactions
Update 1-20 distinct transactions sequentially. The operation is not atomic: successful updates are not rolled back, each item has an explicit outcome, and processing stops after an authentication, permission, rate-limit, server, unexpected
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > Browse MCP Servers. 2. Find PocketSmith in the finance category and click Connect. 3. You'll be prompted to paste a PocketSmith API key — log into PocketSmith, go to Settings > Security > Developer Keys, and generate a new key with read/write access. 4. Copy the key and paste it into Switchy's prompt, then click Authorize. 5. Switchy will test the connection by calling Get Current User to confirm your user ID. 6. Once connected, open any Project and type '@PocketSmith get my budget summary for January 2025' to verify the integration works. 7. The MCP will return your income and expense totals for that period, confirming it can read your financial data.
What teammates see: by default, memories from PocketSmith are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Monthly Spend Recap
@PocketSmith get my budget summary for this month with weekly intervals and show me the top five expense categories
Log Expense from Receipt
@PocketSmith create a transaction in my primary checking account for $47.82 paid to Whole Foods on January 15, 2025, and categorize it as Groceries
Review Recent Transactions
@PocketSmith list my last ten transactions across all accounts and flag any that are still pending review
Forecast Next Quarter
@PocketSmith get my budget for Q2 2025 and highlight any categories where forecast expenses exceed my budget limit
Reorganize Budget Categories
@PocketSmith create a new category called Travel with subcategories for Flights, Hotels, and Meals, then move my existing Airfare category under Flights
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@PocketSmith show me my budget summary for the last 3 months broken down by month, and highlight any categories where I'm over budget
Based on your PocketSmith data for October through December 2024, your total income was $18,450 against expenses of $16,920, leaving a surplus of $1,530. Three categories exceeded their budgets: Dining Out ran 23% over ($890 actual vs $725 budgeted), Entertainment was 18% over ($530 vs $450), and Transportation exceeded by 12% ($670 vs $600). Your largest expense categories were Housing ($4,200), Groceries ($1,850), and Transportation. Income remained stable across all three months at approximately $6,150 per month.
This example uses Get Budget Summary to retrieve aggregated financial data over a date range. The MCP returns actual vs. forecast figures at the category level, which the AI then analyzes for overspending patterns. Requires read access to the user's budget data via API key.
@PocketSmith create a new transaction for $127.50 spent at Whole Foods yesterday, categorize it under Groceries, and mark it as reviewed
I've created transaction #8472951 in your Primary Checking account for $127.50 dated January 14, 2025, with payee 'Whole Foods'. The transaction is categorized under Groceries and marked as reviewed. This expense now appears in your January budget tracking and will be included in your month-to-date spending calculations. Your Groceries category has $872.50 remaining in its January budget allocation.
This demonstrates Create Transaction, which writes directly to your PocketSmith account. The MCP requires a valid transaction account ID (obtained via List Accounts) and returns the created record with its assigned ID. This is a permanent write operation that immediately affects your budget calculations and cannot be undone through the MCP.
@PocketSmith pull all my uncategorized transactions from the past 30 days and suggest appropriate categories based on the payee names and amounts
I found 12 uncategorized transactions totaling $1,847.32. Suggested categorizations: 'Chevron' ($45.00, $52.30) → Transportation/Fuel; 'Netflix' ($15.99) → Entertainment/Subscriptions; 'CVS Pharmacy' ($23.45, $67.80) → Healthcare/Pharmacy; 'Starbucks' (4 transactions, $31.60 total) → Dining Out/Coffee; 'Amazon.com' ($892.18, $419.00) → Shopping (review these manually—amounts suggest different purchase types); 'Verizon Wireless' ($85.00) → Utilities/Phone. The two Amazon transactions likely need different categories based on what you purchased.
This combines Get Transaction (or list operations) with AI reasoning to analyze transaction patterns. The MCP provides raw transaction data including payees and amounts; the AI infers categories by recognizing merchant patterns. You'll still need to manually apply these categorizations in PocketSmith—the MCP can create/update transactions but batch categorization requires individual API calls per transaction.
Use-case deep-dives
When PocketSmith wins for solo financial planning
A freelance designer with irregular income needs to review actual spending against forecast every month. PocketSmith's Get Budget and Get Budget Summary tools let Switchy pull category-level actuals and forecasts in one call, then surface variance alerts without opening the PocketSmith UI. The Create Transaction tool handles manual entry for cash expenses during the review. This works because the 14-tool scope covers the full budget-review loop: read accounts, read categories, analyze budget, create transactions. The threshold: if you need multi-currency consolidation or real-time bank feeds during the review, PocketSmith's API won't surface those—you'll still open the app. For monthly retrospectives on a single-currency book, this MCP closes the loop in Switchy.
PocketSmith handles month-end categorization for small teams
A 6-person startup closes books on the last Friday of each month. The finance lead needs to bulk-categorize uncategorized transactions and verify budget actuals before sending reports to the founder. PocketSmith's List Categories, Get Transaction, and Create Category tools let Switchy surface uncategorized items, suggest categories based on payee patterns, and create new categories on the fly without leaving the workspace. The Get Budget tool confirms actuals match expectations before export. This scenario works because PocketSmith's category hierarchy and budgeting flags are exposed in the API—Switchy can enforce the team's chart of accounts. The limit: if your startup has more than one entity or needs accrual adjustments, PocketSmith's cash-basis model won't cut it. For single-entity cash accounting, this MCP keeps month-end in Switchy.
When PocketSmith falls short for multi-client financial ops
A 12-person agency manages budgets for 8 retainer clients and needs weekly check-ins on project spend. PocketSmith's Get Budget Summary can pull actuals by category and date range, but the API is user-scoped—there's no multi-user or workspace-level aggregation. Each client budget lives in a separate PocketSmith user account, so Switchy would need 8 API keys and 8 separate calls to consolidate spend. The Create Transaction tool works for one-off adjustments, but bulk imports or cross-client reconciliation aren't supported. This scenario breaks because PocketSmith is built for personal finance, not multi-tenant ops. If your agency has fewer than 3 clients and each has a dedicated PocketSmith user, the MCP is viable. Beyond that, you need a multi-entity accounting platform.
Frequently asked
What does the PocketSmith MCP do in Switchy?
It connects your team's PocketSmith account so AI agents can read budgets, create transactions, manage categories, and analyze spending patterns. Useful for finance teams who want AI to pull actual vs forecast data, categorize expenses, or answer questions like 'how much did we spend on software last quarter' without opening PocketSmith.
Do I need a PocketSmith API key to connect this MCP?
Yes. You generate an API key from your PocketSmith developer settings, then paste it into Switchy during setup. The key grants access to whichever PocketSmith user account created it, so use a shared team account if multiple people need the data. No OAuth flow—just the key.
Can the MCP edit or delete existing transactions?
It can create new transactions and read existing ones, but the available tools don't include update or delete operations. If you need to fix a transaction, you'll still open PocketSmith directly. The MCP is better suited for logging new entries and pulling reports than bulk editing historical data.
How is this different from just exporting CSV files from PocketSmith?
The MCP pulls live data on demand, so your AI agent always sees current balances and budget forecasts without manual exports. You can also create transactions programmatically—useful if you're logging expenses from Slack or email. CSV exports are static snapshots; this is a two-way connection.
Who on the team should generate the API key?
Whoever owns your PocketSmith subscription or has admin access to the account you want Switchy to read. The API key inherits that user's permissions, so if you connect a personal PocketSmith account, only that person's data is visible. For shared visibility, use a team-owned PocketSmith login.