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.

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.

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.

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.