Splitwise

Tool to add a new friend to Splitwise. Use when you have the friend's email and name details ready.

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 to create a comment on a specific expense. Use when you need to add a comment or note to an existing 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 to add multiple friends at once to Splitwise. Use when you need to add several friends in a single operation.

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 to delete a comment by its ID. Use after confirming you have a valid comment ID.

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 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 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 to retrieve expense categories. Use when you need to list available categories before creating an expense.

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 to retrieve a list of supported currencies. Use when you need to display or validate currency options.

Tool to retrieve information about the current authenticated user. Use when you need profile details of the logged-in user.

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 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 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 to list current user's friends on Splitwise. Use when you need to view all friends, their balances, and shared groups.

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.

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 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.

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 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 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 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 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 to update user account details including name, email, password, and preferences. Use when you need to modify the current user's profile information.