How do I install the Splitwise skill?

Run npx skillmds@latest add modbender/splitwise in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Splitwise safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Splitwise?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Splitwise free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Splitwise?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Splitwise by modbender — Agent Skill

Name: Splitwise
Rating: 4.5 (4 reviews)
Author: modbender

File contents

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

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.

---name: splitwisedescription: 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](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.

Frequently asked questions

Splitwise