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_KEYis sent in theAuthorizationheader 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.requestandargparselibraries.
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
- 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
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.