list_expenses
List Expenses
Retrieve expenses for the authenticated user. Filter by group, friend, date range, or update time. Returns expense details including cost, description, category, splits, and repayments.
list_expenses
Retrieve expenses for the authenticated user. Filter by group, friend, date range, or update time. Returns expense details including cost, description, category, splits, and repayments.
delete_group
Delete or restore a Splitwise group. Deleting a group also destroys all associated expenses. Restoring brings a deleted group back.
list_comments
Retrieve all comments on a specific expense. Returns both user comments and system-generated comments (e.g., change tracking).
update_expense
Update an existing Splitwise expense. Only provide fields you want to change. If any user shares are provided, all shares for the expense will be overwritten with the new values.
manage_group_members
Add or remove a user from a Splitwise group. Use this to manage group membership.
get_currencies
Retrieve the list of all currencies supported by Splitwise. These are mostly ISO 4217 codes but may include unofficial codes (e.g., BTC for Bitcoin).
update_user
Update the current authenticated user's profile settings. Supports changing name, email, locale, and default currency.
get_current_user
Retrieve the authenticated user's profile including name, email, default currency, locale, and profile picture.
get_categories
Retrieve the hierarchical list of expense categories supported by Splitwise. Categories have parent categories and subcategories. When creating expenses, a subcategory ID must be used.
add_friend
Add one or more friends to the authenticated user's Splitwise account by email address. Non-Splitwise users will receive an invitation.
delete_friend
Remove a friend from the authenticated user's Splitwise account. The friendship can only be removed if there is no outstanding balance.
create_expense
Create a new expense in Splitwise. You can either split it equally among a group, or provide custom paid/owed shares per user. For equal splits, supply a `groupId` and set `splitEqually` to true. For custom splits, provide a `shares` array with each user's paid and owed amounts.
delete_comment
Delete a comment from a Splitwise expense.
create_comment
Add a comment to a Splitwise expense. Comments are visible to all users involved in the expense.
list_friends
List all friends of the authenticated user with their balances. Returns overall balances and per-group balances showing who owes whom.
get_user
Retrieve a Splitwise user's profile by their user ID. Returns their name, email, registration status, and profile picture.
list_groups
List all groups the authenticated user belongs to. Returns group details including members, balances, and simplified debts. Group ID 0 represents expenses not associated with any group.
get_expense
Retrieve detailed information about a specific expense, including cost, splits, repayments, category, and comments count.
create_group
Create a new Splitwise group for sharing expenses. You can specify the group type and optionally add initial members by user ID or email.
delete_expense
Delete or restore a Splitwise expense. Deleted expenses can be restored using the restore action.
get_group
Retrieve detailed information about a specific Splitwise group, including members, balances, debts, and settings.
Split bills and manage shared expenses among friends and groups. Create, update, and delete expenses with equal or custom splits. Manage groups for households, trips, or other shared-cost scenarios. Track balances and debts between friends across multiple currencies. Add and remove friends, comment on expenses, and retrieve account notifications. Access supported currencies and hierarchical expense categories.
Common questions about connecting Splitwise to AI agents with Metorial.