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

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

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

• Create a Splitwise App at https://secure.splitwise.com/apps.
• Generate a "Long-lived User Token".
• Store it as SPLITWISE_API_KEY.
• Use the API to find your User IDs and Group IDs.

Model Invocation Note

Trust Statement