Splitwise
Your Toolhouse AI Worker can connect to Splitwise using 27 specialized tools.
Auth Connection
This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.
Tools (27)
Splitwise Add Friend
Splitwise Add FriendIntegration name: SPLITWISE_ADD_FRIEND
Tool to add a new friend to Splitwise. Use when you have the friend's email and name details ready.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
user_email
string
✅
"friend@example.com"
Email address of the friend to add
user_last_name
string
"Doe"
Last name of the friend (optional)
user_first_name
string
✅
"John"
First name of the friend; required by Splitwise to create a new friend entry
Splitwise Add User To Group
Splitwise Add User To GroupIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
user_id
integer
✅
2084357
The ID of the user being added to the group
group_id
integer
✅
90997466
The ID of the group to add the user to
Splitwise Create Comment
Splitwise Create CommentIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
content
string
✅
"Does this include tax?"
The text content of the comment.
expense_id
integer
✅
4196161261
The ID of the expense to which the comment will be added.
Splitwise Create Expense
Splitwise Create ExpenseIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
cost
string
✅
"25.00"
Total cost as string decimal (up to 2 decimal places)
date
string
"2026-01-25T18:30:00Z"
Date when the expense occurred (ISO 8601 format). Defaults to current time if omitted
users
array
—
List of participants with custom share amounts. Required when using custom splits instead of split_equally Each user object must include paid_share and owed_share as decimal strings with up to 2 decimal places (e.g., '25.00').
details
string
—
Additional notes or details about the expense
group_id
integer
✅
0
ID of the group to add this expense to. Use 0 for expenses between friends (not in a group)
category_id
integer
15
Expense category ID (use get_categories action to retrieve valid IDs). Defaults to 'General'
description
string
✅
"Grocery run"
Brief description of what the expense is for
currency_code
string
"USD"
3-letter ISO currency code (e.g., USD, EUR, GBP). Defaults to user's default currency
split_equally
boolean
true
Set to true to split cost equally. When group_id=0, you must also provide users list to specify participants
repeat_interval
string
"monthly"
How often this expense repeats. Use 'never' or omit for one-time expenses
Splitwise Create Friends
Splitwise Create FriendsIntegration name: SPLITWISE_CREATE_FRIENDS
Tool to add multiple friends at once to Splitwise. Use when you need to add several friends in a single operation.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
users
array
✅
[{"email":"alan@example.org","last_name":"Turing","first_name":"Alan"}]
List of users to add as friends. Each user must have an email and first_name.
Splitwise Create Group
Splitwise Create GroupIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
name
string
✅
"Trip to Paris"
The name of the group to create
users
array
—
List of users to add to the group. Each user needs either user_id or email. If invited by email only, first_name is required by Splitwise; last_name is optional.
group_type
string
"trip"
Type of group being created. Options: 'home', 'trip', 'couple', 'other', 'apartment', 'house'
simplify_by_default
boolean
true
Whether to turn on simplified debts for this group
Splitwise Delete Comment
Splitwise Delete CommentIntegration name: SPLITWISE_DELETE_COMMENT
Tool to delete a comment by its ID. Use after confirming you have a valid comment ID.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
971044906
The unique identifier of the comment to delete.
Splitwise Delete Expense
Splitwise Delete ExpenseIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
12345
Unique identifier of the expense to delete.
Splitwise Delete Friend
Splitwise Delete FriendIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
friend_id
integer
✅
123456
The unique identifier of the friend to delete.
Splitwise Delete Group
Splitwise Delete GroupIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
91033637
The unique identifier of the group to delete.
Splitwise Get Categories
Splitwise Get CategoriesIntegration name: SPLITWISE_GET_CATEGORIES
Tool to retrieve expense categories. Use when you need to list available categories before creating an expense.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Splitwise Get Comments
Splitwise Get CommentsIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expense_id
integer
✅
3896022943
The ID of the expense for which to retrieve comments.
Splitwise Get Currencies
Splitwise Get CurrenciesIntegration name: SPLITWISE_GET_CURRENCIES
Tool to retrieve a list of supported currencies. Use when you need to display or validate currency options.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Splitwise Get Current User
Splitwise Get Current UserIntegration name: SPLITWISE_GET_CURRENT_USER
Tool to retrieve information about the current authenticated user. Use when you need profile details of the logged-in user.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Splitwise Get Expense
Splitwise Get ExpenseIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
4196161261
The unique identifier for the expense.
Splitwise Get Expenses
Splitwise Get ExpensesIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
limit
integer
10
Maximum number of expenses to return per request. Useful for controlling page size.
offset
integer
0
Number of expenses to skip for pagination. Use for loading subsequent pages of results.
visible
boolean
true
Show only non-deleted expenses when true. Set to false to include deleted expenses.
group_id
integer
12345
Filter expenses by specific group ID. Returns only expenses belonging to this group.
friend_id
integer
67890
Filter expenses by specific friend ID. Returns only expenses involving this friend.
dated_after
string
"2024-01-01T00:00:00Z"
Return expenses dated after this date. Must be ISO 8601 datetime format.
dated_before
string
"2024-12-31T23:59:59Z"
Return expenses dated before this date. Must be ISO 8601 datetime format.
updated_after
string
"2024-01-01T00:00:00Z"
Return expenses updated after this date. Must be ISO 8601 datetime format.
updated_before
string
"2024-12-31T23:59:59Z"
Return expenses updated before this date. Must be ISO 8601 datetime format.
Splitwise Get Friend
Splitwise Get FriendIntegration name: SPLITWISE_GET_FRIEND
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
2084357
User ID of the friend to retrieve
Splitwise Get Friends
Splitwise Get FriendsIntegration name: SPLITWISE_GET_FRIENDS
Tool to list current user's friends on Splitwise. Use when you need to view all friends, their balances, and shared groups.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Splitwise Get Group
Splitwise Get GroupIntegration name: SPLITWISE_GET_GROUP
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
12345
The unique identifier of the group to retrieve. Use 0 to get non-group expenses.
Splitwise Get Groups
Splitwise Get GroupsIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Splitwise Get Notifications
Splitwise Get NotificationsIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
limit
integer
0
Maximum number of notifications to return. Omit or provide 0 to get the maximum number of notifications. The server sets arbitrary (but large) limits on the number returned.
updated_after
string
"2020-07-28T20:46:00Z"
If provided, returns only notifications after this time. Must be ISO 8601 datetime format.
Splitwise Get User
Splitwise Get UserIntegration name: SPLITWISE_GET_USER
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
104819933
The user ID of the person whose information you want to retrieve Prefer IDs sourced from SPLITWISE_GET_GROUP responses to ensure validity.
Splitwise Remove User From Group
Splitwise Remove User From GroupIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
user_id
integer
✅
107522656
The ID of the user to remove from the group. User must have a zero balance in the group to be removed.
group_id
integer
✅
90996631
The ID of the group from which to remove the user
Splitwise Undelete Expense
Splitwise Undelete ExpenseIntegration name: SPLITWISE_UNDELETE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
3896437486
The unique identifier of the expense to restore.
Splitwise Undelete Group
Splitwise Undelete GroupIntegration name: SPLITWISE_UNDELETE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
91033632
The unique identifier of the group to restore.
Splitwise Update Expense
Splitwise Update ExpenseIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
4196161261
ID of the expense to update
cost
string
"25.00"
Total cost as string decimal with max 2 dp
date
string
"2012-05-02T13:00:00Z"
When the expense took place (ISO 8601) Convert natural-language or locale-specific dates to ISO 8601 before sending.
users
array
—
List of custom share allocations. WARNING: If provided, ALL expense shares will be overwritten Each user entry must include paid_share and owed_share; both fields must each independently sum exactly to cost. Omit this field entirely unless a full overwrite of all shares is intended.
details
string
—
Additional notes for the expense
group_id
integer
0
Group ID to assign this expense to (0 for no group)
category_id
integer
15
Category ID from get_categories
description
string
"Updated test expense via API"
Short description of the expense
currency_code
string
"USD"
3-letter currency code, e.g., USD
repeat_interval
string
"never"
Repeat interval for the expense
Splitwise Update User
Splitwise Update UserIntegration name: SPLITWISE_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
104819933
The user ID to update. Must be the authenticated user's ID.
email
string
"john.doe@example.com"
User's email address
locale
string
"en"
Language/region preference (e.g., 'en', 'es', 'fr')
password
string
—
User's account password
last_name
string
"Doe"
User's family name
first_name
string
"John"
User's given name
default_currency
string
"USD"
Preferred currency code (e.g., 'USD', 'EUR', 'GBP')