---
name: benepass-reimbursement
description: "Submit expense reimbursements through Benepass (app.getbenepass.com). For users whose employer uses Benepass as their benefits platform. Handles login, benefit selection, form filling, receipt upload, and submission. Requires browser/computer-use capabilities."
---
# Benepass Reimbursement Skill
Automate the complete Benepass reimbursement flow — from login through submission — using browser automation, Gmail integration for verification codes, and file upload for receipts.
---
## Prerequisites
- Enable **browser access** (computer tool) for navigating Benepass
- Enable **code execution & file creation** — required for saving and uploading receipt files
- Configure **Gmail MCP** for fetching email verification codes
- Determine the email via Gmail MCP; if Gmail access is unavailable, ask for it
- Obtain a receipt image (screenshot, photo, or PDF)
---
## Step 1: Extract Receipt Details
Before navigating to Benepass, extract the key details from the receipt image or message:
- **Amount** (e.g., $84.99)
- **Merchant** (e.g., Verizon, DoorDash, Lyft)
- **Memo/Note** — apply the provided memo, or default to a short description (e.g., "Home wifi", "Lunch", "Ride to office")
- **Benefit category** — select the specified category; infer from context when confident, otherwise prompt for clarification (see Step 4)
---
## Step 2: Login to Benepass
### 2a. Navigate and enter email
```
Navigate to: https://app.getbenepass.com
```
- Click the email input field and type the email address
- Two login options appear: **"Log in with G-Suite"** and **"Log in with Email Code"**
- Click **"Log in with Email Code"**
### 2b. Fetch verification code from Gmail
Wait for the "Enter verification code" prompt with 6 input boxes to appear.
Fetch the code via Gmail MCP:
```
Gmail search query: "from:benepass verification code"
maxResults: 1
```
- Extract the 6-digit code from the email snippet (look for "Your verification code is: XXXXXX")
- Type the 6-digit code into the verification input — the page auto-submits after all 6 digits are entered
- Wait 3-5 seconds for the dashboard to load
### 2c. Verify login success
Verify the dashboard loads with a greeting, account balances, and insights cards to confirm login success.
**Important**: Handle expired verification codes as follows:
- Click "Didn't receive it? Resend" on the verification page
- Wait 5 seconds, then search Gmail again for a newer code
---
## Step 3: Start Reimbursement
- Click the **"Get reimbursed"** button in the left sidebar
- Wait for the reimbursement form to load with two sections:
1. **Select benefit** (dropdown)
2. **Enter details** (amount, merchant, note, receipt)
---
## Step 4: Select Benefit
- Click the **"Select benefit"** dropdown
- Select the specified category; infer from context when confident, otherwise prompt for clarification
- Read the available benefit options directly from the dropdown — categories vary by employer
- Check that the displayed balance for the selected benefit covers the reimbursement amount
---
## Step 5: Fill in Details
### Amount field
**CRITICAL**: Clear any pre-populated value from the amount field before entering the correct amount.
- Triple-click the amount field to select any existing value
- Type the correct amount (e.g., `84.99`)
- Do NOT include the `$` sign — enter just the number
### Merchant field
- Click the merchant input field
- Type the merchant name (e.g., `Verizon`, `DoorDash`, `Lyft`)
### Note field (Optional but recommended)
- Click the note input field
- Type the memo (e.g., `Home wifi`, `Lunch`, `Ride to office`)
---
## Step 6: Upload Receipt
**CRITICAL**: The file input is a **hidden element** with `id="fileInput"`. The visible drop zone is not clickable — use the hidden input instead. If no element with `id="fileInput"` is found, search for any `` on the page.
1. Use `read_page` with `filter: interactive` to find the file input element
2. Look for: ``
3. Use the `upload_file` tool with the ref for that hidden input:
```
upload_file:
file_path:
ref:
```
4. After upload, verify:
- The **Receipt** label is no longer red (was red before upload)
- A "Files uploaded" section appears showing the filename and size
- A thumbnail preview of the receipt is visible
---
## Step 7: Submit
- Scroll down to see the **"Submit reimbursement"** button
- **Before clicking submit**, present a summary for confirmation:
- Benefit category
- Amount
- Merchant
- Memo/note
- Receipt filename
- Remaining benefit balance after this submission
- Wait for explicit approval before proceeding
- Click **"Submit reimbursement"**
- Wait 3 seconds for processing
### Verify submission success
After submission, the page redirects to an expense details view showing:
- **State**: Pending
- **Payment method**: Reimbursement
- **Benefit**: The selected benefit name
- **Payout progress**: Outstanding amount = the submitted amount
Report the confirmation.
---
## Troubleshooting
### Session expired
Handle session expiration by restarting from **Step 2** (login) when errors occur or the page redirects to login.
### Verification code not working
Handle expired verification codes: click "Didn't receive it? Resend", wait a few seconds, then re-search Gmail for a newer code. Ensure the **most recent** email is fetched (use `maxResults: 1` with default sort).
### Amount field quirk
Always triple-click the amount field to select all existing text before typing the new amount — this avoids concatenation (e.g., `32184.99`).
### Upload not registering
If the receipt upload does not appear to work:
1. Re-read the page with `read_page` to find the `fileInput` ref
2. If `fileInput` is not found, search for any `` element
3. Retry uploading with `upload_file` using the correct ref
4. Verify the "Files uploaded" section appears after upload
### Benefit balance too low
If the selected benefit lacks sufficient balance, report the issue and ask whether to use a different benefit category.