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

Expense Operations

Group Operations

Friend Operations

Comment Operations

Reference Data

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

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](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=splitwise) -- an integration hub for OpenClaw