# Splitwise MCP for AI Agents AI Agent Connect > Splitwise MCP connects your account to your AI agent so you can manage shared expenses, check balances, and log bills without leaving your chat or workspace. It lets your agent handle the math and data entry for group travel, roommates, or shared projects. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Z9kupykdVIdT8C673gFW7LictGBFFtKKazEo9daM/ai-agent-connect - **Tags:** expense-tracking, bill-splitting, debt-management, group-finance, personal-finance, reimbursement ## Description Handling shared costs is usually a chore of switching tabs, copying numbers from receipts, and manually calculating percentages. This Connector changes that by giving your AI agent direct access to your Splitwise data. Instead of manually typing in every coffee or hotel charge, you can just hand off the receipt to your agent. It'll parse the details and put them right where they belong. You can also ask your agent to pull up group balances or see who's in a specific circle. It's about removing the friction of manual data entry. When you use this with the Vinkius catalog, you're basically giving your agent a way to do the boring stuff of personal finance. You get to stop being the human calculator for your friend group and start just telling your agent what happened. ## Tools ### create_expense Adds a new bill to Splitwise with specific cost and split details. This is useful for logging receipts without manual entry. ### get_current_user Retrieves your own profile details from the account. ### get_friends Lists every friend connected to your account for quick reference. ### get_group Shows the details of a specific group you belong to. ### get_expenses Lists all your past and current expenses so your agent can see your history. ### get_friend Pulls specific details for a single friend in your network. ### get_groups Lists all your active groups so you can find the right one. ### get_user Fetches specific information about a user by their unique ID. ### get_expense Pulls the data for one specific transaction. ### delete_expense Removes a specific expense from your history if you made a mistake. ## Prompt Examples **Prompt:** ``` Check how much I currently owe in the 'Paris Trip' group. ``` **Response:** ``` Scanning the Paris Trip group balances... According to Splitwise, you currently owe $45 in total (mostly for dinner last night). ``` **Prompt:** ``` Add a new $100 expense for Uber rides to Splitwise and split it equally with Jane. ``` **Response:** ``` Okay. I've created the $100 expense 'Uber rides' and split it equally. You are owed $50 from Jane. ``` **Prompt:** ``` List all my friends connected on Splitwise. ``` **Response:** ``` Here is the list of your friends on Splitwise: 1. John (id: 412), 2. Sarah (id: 331). ``` ## Capabilities ### Add new expenses Your agent can log costs directly into Splitwise with custom splits. ### Check group balances See exactly who owes what across different shared groups. ### Manage group members Pull details of everyone in a specific group for better organization. ### Delete old records Remove incorrect entries from your history quickly. ### Fetch specific details Get info on a single expense or user profile on demand. ## Use Cases ### The Travel Recap You just got back from a trip. Ask your agent to add these 5 dinner receipts to the Italy Trip group and it uses create_expense to sync them. ### Roommate Utilities Every month, tell your agent to check the Apartment group to see if the electric bill was paid. ### Friend Group Debt Ask your agent who owes you money in the Weekend Trip group and it pulls the data from get_groups. ### Correction Mode You entered a bill wrong. Tell your agent to delete the $50 Uber charge from yesterday and it triggers delete_expense. ## Benefits - Stop manual data entry: Use create_expense to let your agent do the typing for every receipt you get. - Instant balance checks: Ask your agent to run get_groups and see who owes what without opening the app. - Automated split calculations: Your agent handles the math for percentages or custom amounts when logging bills. - Better group management: Quickly find members using get_friends to keep your shared circles organized. - Accurate history tracking: Use get_expenses to give your agent a full view of past spending patterns. ## How It Works The bottom line is you get an AI agent that handles the data entry and math for your shared bills. 1. Log into your Splitwise account and generate a personal API token in the Developer Applications settings. 2. Paste that API key into the Vinkius vault. 3. Ask your AI client to check your balance or add a new bill. ## Frequently Asked Questions **Can the Splitwise MCP add bills for me?** Yes, it lets your agent create new expenses with specific costs and splits. You just provide the info, and it handles the entry. **How do I see my group balances with Splitwise MCP?** Your agent can pull data from all your groups to show you exactly who owes what in real-time. **Can I use it to manage roommates?** It's perfect for that. You can ask your agent to log shared bills or check the status of any group. **Does the Splitwise MCP work with my existing friends list?** Yes, it can pull your full friend list and group details so your agent knows who's who. **Can I delete an expense if I make a mistake?** Your agent can use the delete tool to remove any incorrect entries from your history. **How do I set up the Splitwise MCP?** You just need to generate an API token from your Splitwise developer settings and add it to the Vinkius vault. **Can the agent distribute the bill unequally?** Yes! When creating an expense, the AI agent can pass detailed users configuration in JSON to specify exact dollar amounts for each involved party. **How far back does the expense log go?** The agent typically limits the reading to the 20 most recent expenses to keep memory manageable, but can be instructed to pull earlier ones. **Can the bot settle debts?** Currently, the agent interacts with expenses. To log a debt settlement, the agent submits a specific 'payment = true' expense wrapper via the splitwise schema.