# PocketSmith (read-only)

> PocketSmith (read-only) is an MCP server for finance and payments. Read-only PocketSmith access: analyse budgets, spending and forecasts without edits. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://www.pocketsmith.com/mcp
- **MCP Registry name:** com.pocketsmith/mcp-readonly
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-15

## About

This endpoint is the cautious half of PocketSmith's official server. It exposes 40 view-only tools, and the docs say to choose it if you want a guarantee that an assistant can never change your data. Anything involving creating, updating or deleting sits on the separate full-access server.

What remains is the analysis side: a financial health snapshot with net worth and budget traffic lights, a month-end review with savings rate and budget variance, comparisons between two periods, a scan for recurring charges and subscriptions, and balance forecasts. Navigation tools hand back a link to the matching PocketSmith page or report.

Unlike the full-access app, this mode is not listed in the Claude or ChatGPT directories yet. You add it by hand as a custom connector with the URL https://mcp-readonly.pocketsmith.com/mcp, or with claude mcp add or codex mcp add, and then authorise through OAuth in PocketSmith. ChatGPT needs Developer mode enabled and the connector created on chatgpt.com rather than in the desktop app.

## Features

- **View-only tools:** 40 tools that read and analyse but never change data.
- **Health snapshot:** Net worth, spending pace and budget traffic lights in one call.
- **Subscription finder:** Scans history for recurring charges and totals their annual cost.
- **Balance forecasts:** Projects account balances ahead with PocketSmith's forecasting engine.
- **Report deep links:** Returns links to the relevant PocketSmith report.
- **Scoped OAuth token:** The assistant's token is limited to read-only access.

## Good for

- Review a month's income, expenses and savings rate
- Compare this month's spending with last month's
- List forgotten subscriptions without risking changes
- Look at a savings forecast for the next six months
- Let a shared assistant see finances with no write access

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-readonly https://mcp-readonly.pocketsmith.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp-readonly.pocketsmith.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-readonly": {
      "url": "https://mcp-readonly.pocketsmith.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-readonly": {
      "type": "http",
      "url": "https://mcp-readonly.pocketsmith.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-readonly": {
      "serverUrl": "https://mcp-readonly.pocketsmith.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp-readonly.pocketsmith.com/mcp
```

Enter a Name (for example "PocketSmith (read-only)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-readonly": {
      "type": "http",
      "url": "https://mcp-readonly.pocketsmith.com/mcp"
    }
  }
}
```

## Tools

- `financial_health_snapshot`: Net worth, spending pace, budget traffic lights and action items.
- `month_end_review`: Full period review with income, expenses, savings rate and budget variance.
- `spending_comparison`: Compares two date periods by category and payee.
- `find_recurring_expenses`: Finds recurring charges and totals their annual cost.
- `list_transactions`: Lists transactions.
- `list_categories`: Shows the category tree.
- `cash_flow_forecast`: Projects account balances forward.
- `get_trend_analysis`: Summarises category spending trends.
- `navigate_to_trends`: Builds a deep link to the Trends report.

## FAQ

### Can this server change my transactions?

No. It exposes 40 read-only tools; categorising transactions needs the full-access server.

### Where do I connect it?

Add https://mcp-readonly.pocketsmith.com/mcp as a custom connector or MCP server in your client.

### Is it in the Claude or ChatGPT directory?

Not yet; the docs say read-only needs manual setup.

### How does sign-in work?

OAuth 2.0 with PKCE; you can revoke access from PocketSmith's authorized applications page.

### How do I add PocketSmith (read-only) to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-readonly https://mcp-readonly.pocketsmith.com/mcp

### What are the best alternatives to PocketSmith (read-only)?

The closest alternatives to PocketSmith (read-only) are Budget Tracker by Smart Money, Portfellow, Shelter, OpenBudget MCP Server and Waypoint Budget.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Budget Tracker by Smart Money](https://ai-powered.com/mcp/budget-tracker-by-smart-money): Budget Tracker by Smart Money is an MCP server for finance and payments.
- [Portfellow](https://ai-powered.com/mcp/portfellow): Portfellow is a freemium MCP server for finance and payments.
- [Shelter](https://ai-powered.com/mcp/shelter): Shelter is a paid MCP server for finance and payments.
- [OpenBudget MCP Server](https://ai-powered.com/mcp/openbudget-mcp-server): OpenBudget MCP Server is an MCP server for finance and payments.
- [Waypoint Budget](https://ai-powered.com/mcp/waypoint-budget): Waypoint Budget is a paid MCP server for finance and payments.
- [Fillfolio MCP](https://ai-powered.com/mcp/fillfolio-mcp): Fillfolio MCP is a freemium MCP server for finance and payments.
- [BankBridge](https://ai-powered.com/mcp/bankbridge): BankBridge is a paid MCP server for finance and payments.
- [BestFolio](https://ai-powered.com/mcp/bestfolio): BestFolio is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/pocketsmith-read-only
