splitwise

name	splitwise
description	Splitwise API integration with managed OAuth for expense sharing automation. Create and manage expenses, groups, friends, comments, and payments. Track balances, split bills equally or by custom shares, and manage group memberships. Use this skill when users want to record shared expenses, track who owes whom, manage expense groups, add friends, or view balance summaries in Splitwise.

Splitwise

Splitwise is an expense-sharing platform for splitting bills, tracking group expenses, and managing who owes whom. This integration uses managed OAuth through ClawLink so you can create expenses, manage groups, track balances, and handle all aspects of shared expenses without managing API keys.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Splitwise
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Splitwise

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  Splitwise API   │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

Create an equally-split expense:

clawlink_execute_tool --integration splitwise --tool splitwise_create_expense --args '{"description": "Dinner at Thai Place", "cost": "85.00", "split_equally": true, "group_id": "12345"}'

View your groups and balances:

clawlink_execute_tool --integration splitwise --tool splitwise_get_groups

List recent expenses:

clawlink_execute_tool --integration splitwise --tool splitwise_get_expenses --args '{"limit": 10}'

Authentication

Splitwise uses OAuth 2.0 managed by ClawLink. No API keys are needed. Authorize access through the ClawLink dashboard with a standard OAuth login flow. The connection is stored securely and refreshed automatically.

Connect at: https://claw-link.dev/dashboard?add=splitwise

Connection Management

List connections:

clawlink_list_integrations

Verify connection:

clawlink_execute_tool --integration splitwise --tool splitwise_get_current_user

Reconnect: If a connection expires, visit the dashboard URL above and reconnect Splitwise.

Security & Permissions

• Read operations (viewing expenses, groups, friends, balances, categories, currencies) are safe and require no confirmation.
• Write operations (creating expenses, groups, friends, comments, updating records) modify data and require confirmation.
• Destructive operations (deleting expenses, groups, friends, comments, removing users from groups) are high-impact and may be irreversible.

Tool Reference

User Operations

Tool	Description	Mode
splitwise_get_current_user	Retrieve the authenticated user's profile	Read
splitwise_get_user	Retrieve basic profile info for any user by ID	Read
splitwise_update_user	Update user account details and preferences	Write

Expense Operations

Tool	Description	Mode
splitwise_get_expenses	List the current user's expenses with optional filters	Read
splitwise_get_expense	Retrieve detailed info about a specific expense	Read
splitwise_create_expense	Create a new expense (split equally or custom shares)	Write
splitwise_update_expense	Update an existing expense's details	Write
splitwise_delete_expense	Delete an expense permanently (irreversible)	Write (Destructive)
splitwise_undelete_expense	Restore a previously deleted expense	Write

Group Operations

Tool	Description	Mode
splitwise_get_groups	List all groups the user belongs to with balances and debts	Read
splitwise_get_group	Retrieve detailed info about a specific group	Read
splitwise_create_group	Create a new group for tracking shared expenses	Write
splitwise_delete_group	Delete a group and all associated records	Write (Destructive)
splitwise_undelete_group	Restore a previously deleted group	Write
splitwise_add_user_to_group	Add a user to an existing group	Write
splitwise_remove_user_from_group	Remove a user from a group (requires zero balance)	Write (Destructive)

Friend Operations

Tool	Description	Mode
splitwise_get_friends	List all friends with balances and shared groups	Read
splitwise_get_friend	Retrieve profile and balance info for a specific friend	Read
splitwise_add_friend	Add a new friend by email and name	Write
splitwise_create_friends	Add multiple friends at once	Write
splitwise_delete_friend	Remove a friend relationship	Write (Destructive)

Comment Operations

Tool	Description	Mode
splitwise_get_comments	Retrieve all comments for a specific expense	Read
splitwise_create_comment	Add a comment to an expense	Write
splitwise_delete_comment	Delete a comment by ID	Write (Destructive)

Reference Data

Tool	Description	Mode
splitwise_get_categories	List available expense categories	Read
splitwise_get_currencies	List supported currencies	Read
splitwise_get_notifications	Retrieve recent activity notifications	Read

Code Examples

Create an equally-split expense in a group:

{
  "tool": "splitwise_create_expense",
  "args": {
    "description": "Grocery run at Costco",
    "cost": "120.50",
    "split_equally": true,
    "group_id": "12345",
    "currency_code": "USD",
    "category_id": "18"
  }
}

Create a custom-split expense between specific users:

{
  "tool": "splitwise_create_expense",
  "args": {
    "description": "Hotel room",
    "cost": "300.00",
    "users": [
      {"user_id": "111", "paid_share": "300.00", "owed_share": "150.00"},
      {"user_id": "222", "paid_share": "0.00", "owed_share": "150.00"}
    ]
  }
}

Get group details with balances:

{
  "tool": "splitwise_get_group",
  "args": {
    "id": "12345"
  }
}

Add a comment to an expense:

{
  "tool": "splitwise_create_comment",
  "args": {
    "expense_id": "67890",
    "content": "I updated the tip amount to 20%"
  }
}

List expenses with date filters:

{
  "tool": "splitwise_get_expenses",
  "args": {
    "group_id": "12345",
    "dated_after": "2026-05-01",
    "dated_before": "2026-06-01",
    "limit": 50
  }
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm splitwise is connected.
2. Call clawlink_list_tools --integration splitwise to see the live catalog.
3. Use splitwise_get_current_user to verify the connection.
4. Use splitwise_get_groups to discover groups and balances.
5. Use splitwise_get_friends to view your friend list.

Execution Workflow

Read Flow:
  get_groups → get_group → get_expenses → get_expense (details)

Write Flow:
  get_friends → create_expense (confirm) → expense created with splits

Group Flow:
  get_groups → create_group → add_user_to_group → create_expense in group

Notes

• When creating expenses, provide exactly one of split_equally or users for shares. Supplying both or neither causes a validation error and no expense is created.
• A 200 OK response does not guarantee success. Always check the success and errors fields in the response.
• Users must have a zero balance in a group before they can be removed from it.
• Group names may share similar strings or differ in case/whitespace. Normalize names when matching and prefer the group ID once identified.
• Deleting expenses is irreversible -- there is no guaranteed undelete. Use undelete_expense only as a best-effort recovery.
• Use group ID of 0 to get non-group expenses.

Error Handling

Status / Error	Meaning
401 Unauthorized	OAuth token expired; reconnect Splitwise from the dashboard
403 Forbidden	User does not have permission for this operation
404 Not Found	Invalid expense, group, friend, or comment ID
422 Unprocessable	Validation error (e.g., both split_equally and users provided)

Troubleshooting

Tools Not Visible

Run clawlink_list_tools --integration splitwise to verify the integration is active. If empty, reconnect at https://claw-link.dev/dashboard?add=splitwise.

Expense Creation Fails

Provide exactly one splitting method: split_equally: true OR a users array with paid/owed shares. Do not provide both.

Cannot Remove User from Group

The user must have a zero balance in the group. Settle outstanding debts first before removing.

Delete Did Not Work

Check the success field in the response. A 200 response does not always mean the operation succeeded. Review any errors in the response body.

Resources

• Splitwise API Docs: https://dev.splitwise.com
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=splitwise
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw