# Splitwise

> Create and manage expenses on Splitwise. Use this skill when the user wants to log a new expense, split a bill, or check their Splitwise balance.

- Skill: `johnalbertini14-glitch/splitwise` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/splitwise`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/splitwise/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/johnalbertini14-glitch/splitwise

---


# Splitwise Skill

This skill allows an agent to interact with the Splitwise API to automate shared expenses.

## Requirements

- `SPLITWISE_API_KEY`: A Long-lived User Token obtained from the [Splitwise Developer Console](https://secure.splitwise.com/apps).

## External Endpoints

| URL | Purpose | Data Sent |
|-----|---------|-----------|
| `https://secure.splitwise.com/api/v3.0/create_expense` | Create a new expense | Cost, description, user IDs, shares, and group ID. |

## Security & Privacy

- **Data Outbound**: This skill sends expense details (cost, description, user IDs) to the Splitwise API.
- **Credentials**: Your `SPLITWISE_API_KEY` is sent in the `Authorization` header to Splitwise. It never leaves the machine except to communicate with the official Splitwise API.
- **Input**: User input for cost and description is handled safely by the Python `urllib.request` and `argparse` libraries.

## Usage

### Logging an Expense
The primary script handles creating a 50/50 split between two users.

```bash
python3 {baseDir}/scripts/add_expense.py \
  --cost "10.00" \
  --desc "Lunch" \
  --payer_id "12345" \
  --other_id "67890" \
  --via "whisker"
```

### Parameters
- `--cost`: Total amount (e.g., "45.00")
- `--desc`: Brief description of the expense.
- `--payer_id`: The Splitwise User ID of the person who paid.
- `--other_id`: The Splitwise User ID of the person being split with.
- `--group_id`: (Optional) The ID of a specific Splitwise group.
- `--via`: (Optional) Appends "(via name)" to the description.

## Setup for Agents
1. Create a Splitwise App at `https://secure.splitwise.com/apps`.
2. Generate a "Long-lived User Token".
3. Store it as `SPLITWISE_API_KEY`.
4. Use the API to find your User IDs and Group IDs.

## Model Invocation Note
This skill is designed for autonomous invocation by AI models. The model will automatically determine when to call these tools based on user requests (e.g., "split the $20 lunch with Nancy").

## Trust Statement
By using this skill, data is sent to Splitwise. Only install this skill if you trust Splitwise with your expense data.