- Money is a string. Splitwise sends every amount as a decimal string such as
"25.0", and this plugin keeps that type in its outputs. Inputs take a number and send it as a two-decimal string. - A 200 can mean the write failed.
groups.delete,groups.undelete,groups.addUser,groups.removeUserand the expense writes answer 200 withsuccess: falseor a populatederrorsmap. The plugin throwsSplitwiseOperationErrorin that case, so a resolved promise means the write applied. - Updates replace shares. Passing
userstoexpenses.updatereplaces every share on the expense. The schema requirescostalongside it. - Splitting.
expenses.createtakes eithersplit_equally: truewith agroup_id, or auserslist whose paid and owed amounts add up tocostin whole cents. Amounts take at most two decimal places. Both are checked before the request. - Writes that reach people are destructive. Adding friends or group members invites them by email, and creating or editing an expense or commenting notifies the people on it.
friends.add,friends.addMany,groups.create,groups.addUser,expenses.create,expenses.updateandcomments.createaredestructive. - Errors. HTTP failures are core’s
ApiError.describeSplitwiseErrorreads the message out of either error body, andisNotLoggedInspots the 401 for a missing or revoked key. - Categories. An expense must use a subcategory from
categories.list; a parent category is rejected by the API. - Rate limits. Splitwise answers 429 when you exceed them and does not publish the exact limits. Core retries a 429 up to three times, honouring
Retry-After. - Reads only are replayed. A 5xx is retried for a read.
expenses.createis not idempotent, so a failed write is returned rather than sent again.
- 27 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Splitwise API key before the first call: More: API Key
pnpm corsair setup --plugin=splitwise --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List your groupsWhat’s next
API reference
Every
splitwise.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.