Splitwise MCP server
27 operations0 webhooks
Read and write a Splitwise account: groups, friends, expenses, comments and notifications.
Try Splitwise with your agent
Connect Splitwise, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Splitwise on my account, then run one read-only example and show me the result.
Splitwise tools and triggers
Tools are what your agent can do in Splitwise through Corsair's MCP server. Triggers are the Splitwise events a routine can start from.
Groups
- Add UserDestructive
Add a Splitwise user, or a new person by name and email, to a group
groups.addUser
- CreateDestructive
Create a group and add members by user ID or by name and email; the current user is added automatically
groups.create
- DeleteDestructive
Delete a group and every expense in it; the group can be restored with `groups.undelete`
groups.delete
- GetRead-only
Get one group with its members, balances and debts
groups.get
- ListRead-only
List the current user groups with their members, balances and simplified debts; expenses outside a group appear as group 0
groups.list
- Remove UserWrite
Remove a user from a group; Splitwise refuses while that user has a non-zero balance
groups.removeUser
- UndeleteWrite
Restore a deleted group
groups.undelete
Expenses
- CreateDestructive
Record an expense, split either equally across a group or by an explicit paid and owed share per person
expenses.create
- DeleteDestructive
Delete an expense; it can be restored with `expenses.undelete`
expenses.delete
- GetRead-only
Get one expense with its shares, repayments and comments
expenses.get
- ListRead-only
List the current user expenses, filtered by group, friend or date, with limit and offset paging
expenses.list
- UndeleteWrite
Restore a deleted expense
expenses.undelete
- UpdateDestructive
Change an expense; passing any share replaces every share on it
expenses.update
Friends
- AddDestructive
Add a friend by email; a first name is needed when the person has no Splitwise account yet
friends.add
- Add ManyDestructive
Add several friends in one call, returning each result alongside any errors
friends.addMany
- DeleteDestructive
Break off the friendship; Splitwise keeps the expenses but the friend is removed from the list and there is no undelete call
friends.delete
- GetRead-only
Get one friend with their balances and shared groups
friends.get
- ListRead-only
List the current user friends with the balance owed either way
friends.list
Comments
- CreateDestructive
Post a comment on an expense
comments.create
- DeleteDestructive
Delete a comment; this cannot be undone
comments.delete
- ListRead-only
List the comments on an expense
comments.list
Users
- GetRead-only
Get another user by ID; Splitwise only answers for people you share a group or expense with
users.get
- Get Current UserRead-only
Get the user the key belongs to, with its notification settings and unread count
users.getCurrentUser
- UpdateWrite
Change a user's name, email, password, locale or default currency
users.update
Categories
- ListRead-only
List expense categories with their subcategories; an expense must use a subcategory
categories.list
Currencies
- ListRead-only
List the currency codes Splitwise accepts
currencies.list
Notifications
- ListRead-only
List recent activity on the account, newest first, optionally after a given time
notifications.list
Connect Splitwise to Claude, ChatGPT or Cursor
- 1
Connect Splitwise in Corsair
Add your Splitwise API key once in Corsair. Corsair stores the credential encrypted and makes the Splitwise API calls for your agent, so it never goes into a prompt or a config file. Connect Splitwise
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Splitwise. On a ChatGPT personal plan, connect Splitwise here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Splitwise's read and write operations run right away and its 11 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/splitwise, add the Splitwise plugin, and connect with an API key. Then call methods like corsair.splitwise.api.categories.list() from your app. Corsair keeps each tenant isolated.
Yes. Splitwise requires an API key from your Splitwise account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Splitwise, GitHub, Notion, Stripe, and the rest. Trigger Splitwise from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for read and write a Splitwise account: groups, friends, expenses, comments and notifications. Common builds include sync jobs, admin tooling, and agents that call Splitwise APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Splitwise API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/splitwise in the open repo. When Splitwise ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Splitwise data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Splitwise data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Splitwise on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 11 destructive Splitwise operations. You can change a link's mode at hub.corsair.dev/me.