Splitwise AI Agent
Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Splitwise MCP or direct API to split expenses, fetch group balances, add expenses, and settle up through natural language.
Connect on Telegram
Splitwise helps you split bills and expenses with friends and family. It makes it easy to track shared costs and settle up, so everyone stays on the same page.
▪ Tools & Triggers
Supported Tools and Triggers
Every Splitwise action and event your agent gets out of the box.
Add Friend
Tool to add a new friend to Splitwise. Use when you have the friend's email and name details ready.
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.
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.
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.
Create Friends
Tool to add multiple friends at once to Splitwise. Use when you need to add several friends in a single operation.
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.
Delete Comment
Tool to delete a comment by its ID. Use after confirming you have a valid comment ID.
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.
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.
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.
Get Categories
Tool to retrieve expense categories. Use when you need to list available categories before creating an expense.
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.
Get Currencies
Tool to retrieve a list of supported currencies. Use when you need to display or validate currency options.
Get Current User
Tool to retrieve information about the current authenticated user. Use when you need profile details of the logged-in user.
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.
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.
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.
Get Friends
Tool to list current user's friends on Splitwise. Use when you need to view all friends, their balances, and shared groups.
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.
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.
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.
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.
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.
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.
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.
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.
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.
No matches.
Put Splitwise on autopilot
Connect Splitwise to your TeleClaw agent and run these 27 tools straight from Telegram.
Get started free