---
title: "Raycast Extension"
description: "Install and configure the Figa Raycast extension: workspace context, expenses, monthly totals and payments from your keyboard."
canonical_url: "https://getfiga.com/help/developers/integrations/raycast/"
---

# 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

1.  Open Figa workspace settings and create a dedicated API key for Raycast.
2.  Choose the read preset for lookup-only commands or the write preset for create and payment workflows.
3.  Copy the key immediately. Figa shows the raw API key only once.
4.  Install or run the Figa Raycast extension and open extension preferences.
5.  Paste the key into API Key.
6.  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. |