Splitwise helps you split bills and expenses with friends and family.
Toolkit · splitwise
v1
01Add Friendtool
02Add User to Grouptool
03Create Commenttool
04Create Expensetool
OAuth2 · verified
27T · 0TR
splitwise
Supported tools and triggers
Each tool is a typed function your agent can call. Each trigger fires an agent run when something changes upstream.
Add Friend
Tool to add a new friend to Splitwise. Use when you have the friend's email and name details ready.
TOOL
Add User to Group
Tool to add a user to a group. Use when you need to add an existing Splitwise user to a specific group. Note: 200 OK does not indicate success; always check the response 'success' field.
TOOL
Create Comment
Tool to create a comment on a specific expense. Use when you need to add a comment or note to an existing expense.
TOOL
Create Expense
Tool to create a new Splitwise expense. Use when you need to record a payment or bill in a group or between users. Provide exactly one of split_equally or users for shares — supplying both or neither causes a validation error and no expense is created.
TOOL
Create Friends
Tool to add multiple friends at once to Splitwise. Use when you need to add several friends in a single operation.
TOOL
Create Group
Tool to create a new group in Splitwise. Use when you need to create a group for tracking shared expenses. The current user is automatically added to the group. You can optionally add other members during creation.
TOOL
Delete Comment
Tool to delete a comment by its ID. Use after confirming you have a valid comment ID.
TOOL
Delete Expense
Tool to delete an existing expense by its ID. Deletion is irreversible — no undelete capability exists. Use after confirming you have the correct expense ID. Inspect the response's `success` and `error` fields to verify deletion succeeded; failures (e.g., user lacks owner/participant permissions) are surfaced there.
TOOL
Delete Friend
Tool to delete an existing friend by ID. Use when you need to remove a friend relationship by its user ID. Call after confirming the correct friend ID.
TOOL
Delete Group
Tool to delete a group and all associated records by its ID. Use when you need to permanently remove a group and its expenses. Call after confirming the correct group ID.
TOOL
Get Categories
Tool to retrieve expense categories. Use when you need to list available categories before creating an expense.
TOOL
Get Comments
Tool to retrieve all comments associated with a specific expense. Use when you need to view comments on an expense, including both system-generated updates and user-authored messages.
TOOL
Get Currencies
Tool to retrieve a list of supported currencies. Use when you need to display or validate currency options.
TOOL
Get Current User
Tool to retrieve information about the current authenticated user. Use when you need profile details of the logged-in user.
TOOL
Get Expense
Tool to retrieve detailed information about a specific expense by ID. Use when you need to view expense details including participants, shares, and repayments.
TOOL
Get Expenses
Tool to list the current user's expenses from Splitwise account. Use when you need to view expenses with optional filters like date ranges, groups, or friends.
TOOL
Get Friend Details
Tool to retrieve detailed information about a specific friend. Use when you need to get profile details and balance information for a friend by their user ID.
TOOL
Get Friends
Tool to list current user's friends on Splitwise. Use when you need to view all friends, their balances, and shared groups.
TOOL
Get Group Details
Tool to retrieve detailed information about a specific group. Returns full group details including members, balances, debts (both original and simplified), avatar URLs, and group settings. Use this when you need comprehensive information about a particular group, such as viewing who owes what to whom. Use group ID of 0 to get non-group expenses.
TOOL
Get Groups
Retrieves all groups the authenticated user belongs to, including group details, members, balances, and debt information. Returns a 'groups' array with no server-side filtering; all name- or ID-based filtering must be done client-side on the full response. Group names may share similar strings or differ in case/whitespace — normalize when matching and prefer group_id once identified. The groups array may be empty if the user belongs to no groups.
TOOL
Get Notifications
Tool to retrieve recent activity notifications from the user's Splitwise account. Returns notifications with HTML content suitable for display, with the most recent items first. Use when you need to view recent account activity or updates.
TOOL
Get User Information
Retrieves basic profile information about any Splitwise user by their ID. Returns the user's name, email, registration status, and profile picture. This endpoint only returns public user information. For the authenticated user's full profile (including notifications, currency preferences, and locale settings), use get_current_user instead.
TOOL
Remove User from Group
Tool to remove a user from a group. Use when you need to remove a user from a specific group. Note: User must have a zero balance in the group for removal to succeed. 200 OK does not indicate success; always check the response 'success' field.
TOOL
Restore Deleted Expense
Tool to restore a previously deleted expense and its associated records. Use when you need to recover an expense that was deleted. Call after confirming the correct expense ID. Not a guaranteed undo mechanism — treat deletion as high-impact and verify restoration completeness afterward.
TOOL
Restore Deleted Group
Tool to restore a previously deleted group and all its associated records. Use when you need to recover a group that was deleted. Call after confirming the correct group ID.
TOOL
Update Expense
Tool to update an existing Splitwise expense. Use when you need to modify expense details such as cost, description, or participant shares. Only include fields you want to change. Note that a 200 OK response does not guarantee success - check that the errors object is empty.
TOOL
Update User
Tool to update user account details including name, email, password, and preferences. Use when you need to modify the current user's profile information.