Raycast Extension

The Figa Raycast extension gives you quick desktop access to workspace context, expenses, monthly totals, categories, recipients, expense creation, and selected-expense payment actions.

Current plan limits apply

Free includes one shared API key or MCP workspace connection slot per organization. After downgrade, the oldest eligible integration remains active and excess keys are suspended. Free exposes the oldest 20 expenses per month across the organization; Pro restores access to retained expenses and eligible keys.

Setup

Open Figa workspace settings and create a dedicated API key for Raycast.
Choose the read preset for lookup-only commands or the write preset for create and payment workflows.
Copy the key immediately. Figa shows the raw API key only once.
Install or run the Figa Raycast extension and open extension preferences.
Paste the key into API Key.
Run Show Workspace Context first to verify workspace, plan, defaults, and capabilities.

API key safety

API keys are shown once. Create a key dedicated to Raycast, store it only in Raycast preferences, and rotate it from Figa workspace settings if it was pasted into logs, screenshots, chat, or another tool.

Preferences

Preference	Value	Notes
`API Key`	Password field	Use a workspace API key. Raycast stores it as an extension password preference.

Capabilities

Every command starts from GET /api/v1/context. Context v2 includes workspace defaults and capability flags derived from the configured key. Raycast uses those flags to show clear permission states before mutation requests are sent.

defaults.baseCurrency pre-fills create-expense currency.
expenses.read gates expense search and monthly totals.
categories.read and recipients.read gate reference commands and create-form choices.
expenses.write gates expense creation.
expenses.payments gates selected-expense mark-paid actions. Legacy write keys may still be accepted by the API payment route.

Commands

Command	Capability	Expected behavior
Show Workspace Context	`workspaces.read`	Shows workspace, plan, critical limits, defaults, capabilities, and key settings links.
Search Expenses	`expenses.read`	Shows current-month expenses with all, unpaid, and paid views plus copy, paste, and Figa links.
Show Monthly Summary	`expenses.read`	Shows recent total, paid, and unpaid monthly values using workspace currency.
Search Categories / Search Recipients	`categories.read`, `recipients.read`	Shows live workspace/global reference data with expense counts and Figa links.
Create Expense	`expenses.write`	Uses workspace defaults and live references, validates form fields, and sends an idempotent create request.
Mark Expense Paid	`expenses.payments`	Reads the expense, asks for confirmation, sets Paid with its context and revisions, then reads current status and refreshes the list.