# SaaSFlow for Raycast

URL: https://www.raycast.com/saasflow/saasflow

> Track MRR, browse customers and transactions, and ask AI questions about your SaaSFlow data without leaving Raycast.

- Install: raycast://extensions/saasflow/saasflow
- Author: [SaaSFlow](https://www.raycast.com/saasflow)
- Installs: 14
- Platforms: macOS
- Categories: Finance, Productivity, AI Extensions
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/cb851627572238835223d44f55f73110835b8ffc/extensions/saasflow/

## Commands

- **MRR & Cash**: Show current MRR and cash balance in the menu bar, refreshed every 15 minutes.
- **Switch Company**: Pick which company other SaaSFlow commands and AI tools act on.
- **Sign out**: Clear stored SaaSFlow OAuth tokens and the active-company selection.

## AI tools

- **List Companies**: List the companies the signed-in user has access to.
- **Get Company**: Get details for a specific company (name, settings, plan).
- **List Company Users**: List the users that have access to a SaaSFlow company, with their role and last-seen time.
- **List Transactions**: Browse, filter, or paginate through transactions. Supports limit, offset, and accountId. Use a data-* tool for aggregations.
- **Get Transaction**: Fetch the details for a single transaction by id.
- **List Customers**: Browse or list customers. Prefer data-customer-mrr or data-cohorts for revenue analytics across customers.
- **Search**: Look something up by name when the exact id is unknown. Returns hits across customers, vendors, accounts, and transactions.
- **Run Data Batch**: Run multiple slice aggregations in one round trip. Prefer a dedicated data-* tool for single aggregations.
- **MRR at Date**: Use this when the user asks for total MRR (or committed MRR) on a specific date. Requires permissions: subscriptions:read.
- **MRR Data**: Use this when the user asks how MRR has changed over time, MRR trend, or monthly recurring revenue history. Requires permissions: subscriptions:read.
- **Monthly Data**: Use this when the user asks for month-by-month revenue, churn, new/upgrade/downgrade breakdowns, or movement summaries. Requires permissions: subscriptions:read.
- **Customer MRR**: Use this when the user asks for MRR broken down per customer, or which customers contribute the most MRR. Requires permissions: subscriptions:read, customers:read.
- **MRR Change Events**: Use this when the user asks for individual MRR change events (new, expansion, contraction, churn) in a period. Requires permissions: subscriptions:read.
- **MRR by Product**: Use this when the user asks how MRR is distributed across products or plans. Requires permissions: subscriptions:read.
- **Analytics**: Use this when the user asks for summary SaaS metrics (MRR, ARR, NRR, GRR, churn, LTV, CAC, burn rate, runway) over a period. Permissions are checked per requested metric: subscription metrics (MRR, ARR, churn, retention, growth) need subscriptions:read, P&L and cash metrics (revenue, margins, burn, runway) need financials:read, and metrics that combine both (CAC payback, LTV, Rule of 40, burn multiple) need both. Requires permissions: subscriptions:read, financials:read.
- **Metric Definitions**: Use this when the user asks how a SaaS metric is defined or calculated (formula, inputs, windows, caps). Static definitions only; use the analytics slice for values. Permissions follow the metrics named, as in the analytics slice; omitting metricNames returns every definition and needs both permissions. Requires permissions: subscriptions:read, financials:read.
- **Metric Explanation**: Use this when the user asks why a metric has its value or how it was computed for a specific month: returns the formula with every part resolved to its real number, the engine value, and any cap or adjustment that made them differ. Permissions follow the explained metric, as in the analytics slice. Requires permissions: subscriptions:read, financials:read.
- **Revenue Expenses**: Use this when the user asks for revenue vs. expenses (P&L summary) for a period. Requires permissions: financials:read.
- **Revenue Expenses Bar**: Use this when the user asks for revenue/expenses charted month-over-month as bars. Requires permissions: financials:read.
- **Revenue Expenses by Category**: Use this when the user asks which categories drive revenue or expenses over a period. Requires permissions: financials:read.
- **Top Expense Vendors**: Use this when the user asks for the top expense vendors over a period. Requires permissions: financials:read, vendors:read, transactions:read.
- **Account Balance KPIS**: Use this when the user asks for cash/bank account balance KPIs (current, start, end, change). Requires permissions: balances:read.
- **Account Balance by Account**: Use this when the user asks for current balances broken down per bank or cash account. Requires permissions: balances:read.
- **Balance Time Series**: Use this when the user asks for cash/bank balances charted over time. Requires permissions: balances:read.
- **Balance by Cash Type**: Use this when the user asks how balances are split across cash types (operating, reserve, savings, etc.). Requires permissions: balances:read.
- **Cash Flow Time Series**: Use this when the user asks for cash inflows and outflows over time. Requires permissions: transactions:read, balances:read.
- **Forecast Cash Flow Time Series**: Use this when the user asks for cash inflows and outflows that run past today, i.e. actuals up to the cutover and planned transactions after it. Use cashFlowTimeSeries when the window ends in the past. Requires permissions: transactions:read, balances:read.
- **Forecast Balance Time Series**: Use this when the user asks where the bank balance is heading: the actual balance up to the cutover, then a projection built from planned transactions. Use balanceTimeSeries for actual balances alone. Requires permissions: transactions:read, balances:read.
- **Cash Flow by Category**: Use this when the user asks which categories drive cash inflows or outflows in a period. Requires permissions: transactions:read.
- **Profit Loss Data**: Use this when the user asks for a P&L statement (revenue, costs, gross/operating/net profit) for a period. Requires permissions: financials:read.
- **Period Details**: Use this when the user asks for the detailed breakdown of a single period (transactions, categorizations, totals). Requires permissions: transactions:read.
- **Cohorts**: Use this when the user asks about customer retention or revenue retention by cohort. Returns the cohort matrix only (one entry per cohort month, MRR and customer count keyed by calendar month) and no customer rows, so it stays small enough to post-process. For the customers behind one cohort/month cell, use cohortCustomers. Requires permissions: subscriptions:read, customers:read.
- **Cohort Customers**: Use this when the user asks which customers make up one cohort, or what is behind a single cell of the cohorts matrix. One cohort month and one target month per call; for the whole matrix use cohorts. Requires permissions: subscriptions:read, customers:read.
- **Customer Monthly Data**: Use this when the user asks for one customer's month-by-month metrics or activity. For per-customer MRR in a month, request dataType "end" (MRR at month end). Requires permissions: subscriptions:read, customers:read.
- **Customer Changes**: Use this when the user asks which customers changed (new/upgraded/downgraded/churned) in a period. Requires permissions: subscriptions:read, customers:read.
- **Retention Cohort Detail**: Use this when the user asks for the customer-level detail behind a specific retention cohort cell. It returns one row per customer in that month, which is a large response on a big account. For retention as numbers, use cohorts (the matrix the shares are computed from) or analytics (NRR, GRR). Requires permissions: subscriptions:read, customers:read.
- **Benchmarks**: Use this when the user asks how the company compares with SaaS peers: growth, retention, churn, gross margin, Rule of 40, CAC payback and burn multiple, each graded green, yellow or red against peer quartiles for the company's ARR stage and ACV segment. Pass arrStage or acvSegment to compare against another peer group. Permissions follow the metrics asked for, as in the analytics slice. Requires permissions: subscriptions:read, financials:read.
- **Valuation**: Use this when the user asks what the company could be worth: an ARR multiple range from growth, net revenue retention, gross margin and burn multiple against peers, for a fundraising or an acquisition lens. Pass scenario to see how other driver values would move it. An orientation, not a fairness opinion. Requires permissions: subscriptions:read, financials:read.

## README

### SaaSFlow

Track your SaaS business from Raycast. Glance at MRR and cash in the menu bar, switch between companies you have access to, and ask AI questions about your SaaSFlow data without opening the dashboard.

Requires a [SaaSFlow](https://saasflow.com) account.

#### Commands

- **MRR & Cash** — menu-bar command. Shows the active company's CMRR (or MRR — switchable in preferences) and current cash balance, refreshed every 15 minutes.
- **Switch Company** — pick which company the menu bar and AI tools act on. The selection is remembered across sessions.
- **Sign Out** — clear the stored OAuth tokens and the active-company selection.

#### Ask SaaSFlow (AI)

The extension registers 38 read-only AI tools so Raycast AI can answer natural-language questions about your data. A few examples:

- *"What's my MRR today?"* → `data-mrr-at-date`
- *"Show me last quarter's P&L"* → `data-profit-loss-data`
- *"Which customers churned in March?"* → `data-customer-changes`
- *"Find the transaction from Stripe on Jan 12"* → `search`, then `get-transaction`
- *"Top 10 expense vendors this year"* → `data-top-expense-vendors`

The 30 `data-*` tools mirror the slices that power the SaaSFlow dashboards (MRR, cohorts, cash flow and balance forecasts, P&L, balances, retention, benchmarks, valuation). Eight hand-tuned tools cover company, customer and transaction lookups and free-text search.

#### Setup

1. Install the extension from the Raycast Store.
2. Open any SaaSFlow command (or @-mention the extension in Quick AI). Raycast pops a browser to `api.saasflow.com` for sign-in and consent.
3. Pick the company you want active via **Switch Company**.

The menu bar fills in as soon as you pick a company. Until you sign in, it offers a **Sign in to SaaSFlow…** item that opens Switch Company.

##### Using an API key instead of OAuth

Prefer not to OAuth? Mint a personal API key in the SaaSFlow dashboard and paste it into **Raycast Settings → Extensions → SaaSFlow → API key (fallback)**. The extension uses the API key when set, and OAuth only as a fallback.

##### Pointing at staging or a self-hosted backend

**Raycast Settings → Extensions → SaaSFlow → API base URL** overrides the default `https://api.saasflow.com`. Useful for SaaSFlow's own staging environment and for testing against a local backend.

#### Privacy

The extension talks only to your configured `apiBaseUrl` (default: `https://api.saasflow.com`) and Raycast's OAuth relay (`raycast.com/redirect`). OAuth tokens and the active-company id are stored in Raycast's local secure store and never sent elsewhere.
