Splitwise MCP. Manage shared expenses and debts instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Splitwise connects your shared expense accounts directly to your AI agent. It lets you track who owes whom across multiple groups, calculate receipts on the fly, and log bills accurately—all without opening a web browser.
Use it for group trips, roommates, or just complicated dinner tabs.
What your AI agents can do
Create expense
Logs a new expense record, requiring cost details and how the money was split among users.
Delete expense
Removes an existing expense record from your Splitwise account.
Get current user
Retrieves basic profile information for the user linked to the API key.
The agent checks and reports real-time balances owed among members of specific groups.
You input cost, description, and split parameters; the tool logs a new expense record into Splitwise.
The agent retrieves details for individual users or lists all members of connected groups.
It fetches a list of existing expenses, allowing you to review financial records and find specific transactions.
You can delete an expense record or retrieve details for a single, specific transaction.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Splitwise MCP Server: 10 Tools for Group Finance
These ten tools let your agent read, write, and manage every aspect of shared group expenses and user accounts in Splitwise.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Splitwise on Vinkius019dd165create expense
Logs a new expense record, requiring cost details and how the money was split among users.
019dd165delete expense
Removes an existing expense record from your Splitwise account.
019dd165get current user
Retrieves basic profile information for the user linked to the API key.
019dd165get expense
Fetches all data points associated with a specific, single expense ID.
019dd165get expenses
Lists multiple recorded expenses, allowing you to see recent or historical spending patterns.
019dd165get friend
Retrieves specific profile details for an individual friend connected to your account.
019dd165get friends
Lists all friends currently linked or visible in your Splitwise network.
019dd165get group
Pulls the full details and member list for one specific group of people.
019dd165get groups
Lists every single group you are currently participating in on Splitwise.
019dd165get user
Gets detailed user data for any specified member ID or name within Splitwise.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Splitwise, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Splitwise. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Tracking shared money shouldn't feel like auditing a tax filing.
Right now, tracking group spending means jumping between the Splitwise app, opening emails for receipts, and then manually updating spreadsheets. You spend 20 minutes just trying to figure out who paid what for that one dinner last month.
With this MCP server, you tell your agent: 'What's my balance with Jane?' It handles the calls to `get_expenses` and calculates the answer instantly. No clicking, no tabs, just a clean number.
Splitwise MCP Server: Log bills in seconds.
Manual entry involves opening the app, finding the 'Add Expense' button, inputting the total cost, selecting every single participant, and then manually assigning percentages. It’s a multi-step click nightmare.
Now, you just tell your agent: 'Log $45 for groceries, split 20% each among four people.' The agent uses `create_expense`, handles the JSON payload, and logs it correctly—done.
What you can do with this MCP connector
Splitwise MCP Server - Track Expenses & Manage Splits
Listen up. This server connects your AI agent right into Splitwise, so you don't have to juggle receipts and spreadsheets anymore. You can keep tabs on who owes what for group trips, roommates, or even just complicated dinner tabs—all without ever opening a browser.
- Record Shared Bills: When you input cost details and how the money was split among users, the agent uses
create_expenseto log the new expense record instantly. You can tell it what the total bill was and specify exactly who is responsible for which portion of that spending. - Audit Past Spending: To review financial records or find specific transactions, you use
get_expenses, which pulls a list of multiple recorded expenses allowing you to see your group's historical spending patterns.
Getting the Details You Need
You need to know who's in the loop and what they spent. The agent uses get_friends to pull a complete list of every person visible in your Splitwise network, letting you keep track of everyone connected to your account. If you need specific background info on one of those people, get_friend pulls detailed profile information for an individual friend.
When the group gets bigger, the agent handles that too. You can use get_groups to list every single group you're part of. For a deep dive into a specific trip or shared living situation, get_group pulls the full details and member roster for one specific group. Need data on just one person in that group? The agent uses get_user, requiring a specific ID or name to get detailed user data for any connected member.
To figure out where you all stand right now, the system checks real-time balances owed among members of specified groups, letting your AI client report current debts instantly. You can also use get_current_user to pull basic profile information about the person linked to the API key, confirming who's running the show.
Checking Individual Transactions
Sometimes you just need to check one thing. If you want all data points associated with a single expense ID, calling get_expense fetches that specific transaction. You can also use get_user to pull detailed information on any specified member ID or name within Splitwise.
If something's wrong and needs cleaning up, the agent handles it. If you need to remove an existing record completely, you call delete_expense, which removes that specific expense entry from your account.
How It All Works Together
Your AI client pulls group structures and member lists by calling tools like get_friends or get_groups. When you tell it to log a bill—say, 'We spent $200 on groceries, split four ways'—the agent doesn't just write the text; it calls create_expense, handling all that complicated backend math and logging automatically.
It also allows you to pull detailed member data via get_user or list groups using get_groups, ensuring your AI client always knows exactly who needs to pay for what.
019dd165-53b2-7130-8f8a-129da1e497e4 
How Splitwise MCP Works
- 1 Log into your Splitwise account and generate a personal API token from the Developer Applications settings.
- 2 Insert that unique Splitwise API Key directly into Vinkius vault for secure access by your AI client.
- 3 Your agent can now call tools like
get_groupsorcreate_expense, performing actions as if you typed them into the native Splitwise app.
The bottom line is: it lets your AI agent act as a hands-on proxy for all your shared financial activities in Splitwise.
Who Is Splitwise MCP For?
Roommates who hate tracking utility bills. Travel organizers managing group funds after a big trip. Freelancers coordinating expenses across multiple client projects. Anyone whose personal finance involves more than two people.
Uses the agent to check the current balances for every participant in the 'Ski Trip' group after a weekend of shared activities.
Tells the agent, 'Log $200 for groceries and split it three ways.' The tool creates the expense record immediately.
Pulls a list of all connected group members to confirm who needs reimbursement after an event or project milestone.
What Changes When You Connect
- Calculate Balances on Demand: Instead of clicking through multiple groups to find out who owes whom, the agent checks current balances using
get_groupsand reports the total debt immediately. This saves time when you just need a quick answer. - Log Receipts with Zero Effort: Forget manually logging bills. Use your AI client to give the agent the details—cost, split method, users—and call
create_expense. The record goes straight into Splitwise. - Comprehensive Audit Trail: You don't have to guess where money went. Calling
get_expensesgives you a list of recent transactions and past spending records, helping you track down that missing dinner tab. - Know Your Network: Quickly check group membership or individual contacts using tools like
get_friends. Need to know who was at the concert? The agent confirms it by callingget_groupdetails. - Full Data Control: If you only need to review one specific bill from three weeks ago, you can call
get_expenseand pull all relevant data points for that single transaction.
Real-World Use Cases
The Trip Debrief
After a week-long group trip, Mark gets overwhelmed by the tabs. Instead of logging into Splitwise and clicking through 15 transactions, he asks his agent: 'What's the total owed in the Ski Trip group?' The agent runs get_groups and then queries balances to give him one clear number.
The Apartment Move
Sarah is setting up a new shared utility tracker. She tells her agent, 'Log $600 for the security deposit paid by me, split equally among four people.' The agent uses create_expense immediately, recording the bill and distributing the debt.
The Weekend Dinner Tab
You just got a receipt for dinner. Instead of opening Splitwise, you tell your agent: 'Add this $300 expense, split by two people, me paying 150 and John paying 150.' The agent uses create_expense to log it correctly.
Checking Past Debt
You can't remember if you settled the gas bill. You ask your agent to 'List all expenses for my friend John.' The agent calls get_expenses and filters by name, giving you a clear history.
The Tradeoffs
Using CSV exports
Exporting the full transaction list to a spreadsheet, then manually calculating who owes whom using formulas.
→
Don't export. Just ask your agent: 'Check all group balances for me.' The agent calls get_expenses and calculates the net owed amount directly.
Relying on memory
Thinking you remember who paid for that last round of drinks, and trying to manually calculate it.
→
Just tell your agent: 'Check the expenses in the Friends group.' The agent runs get_expenses and shows you exactly what was logged.
Ignoring splits
Adding a large bill without telling the agent how it should be split, leading to incorrect individual debt calculations.
→
Always specify the split. Use the tool: 'Create expense for $500; split 60% to me and 40% to Jane.' This uses create_expense correctly.
When It Fits, When It Doesn't
Use this server if your group finances are messy, involve shared bills, or require complex debt tracking. Specifically, if you need to calculate the net balance across multiple people in a single conversation.
Don't use it if your expenses are purely individual (i.e., only you spending money that belongs only to you). In those cases, a simple personal ledger works fine.
If your primary goal is just viewing data and you never need to input or modify records, querying the raw API endpoints might be sufficient—but this MCP server gives you the conversational layer needed for actual debt management using create_expense and get_expenses.
Common Questions About Splitwise MCP
How do I check my current debt using get_expenses on Splitwise? +
You don't need to call get_expenses just to see the balance. You simply ask your agent, 'What is the total owed in the Paris Trip group?' The agent runs the necessary queries and gives you the summarized balance.
Can I delete an expense using the delete_expense tool? +
Yes, if you need to remove a mistake or correct a record, you can ask your agent to use delete_expense by providing the specific ID of the transaction.
What is the difference between get_friend and get_user? +
Use get_friends first to list all contacts. Then, if you need detailed info on a specific person, use get_user with their ID. It's more granular.
Does create_expense handle complex splits? +
Yes. You can specify custom shares (e.g., 20% for one person, $5 fixed amount for another) directly in the prompt, and the agent uses create_expense to log it.
What should I check if my calls to get_friends fail because of authentication issues? +
First, verify your API token within Vinkius. You must use the personal developer API key generated directly in your Splitwise account settings. The agent cannot connect using general or secondary keys.
What happens when I try to use get_expense for a record that has already been deleted? +
The tool returns an explicit 'Not Found' status code. Your AI client should detect this error and prompt the user to check the expense ID or run get_expenses instead.
Does get_group provide the full list of member IDs for a shared circle? +
Yes, it returns the complete roster of members linked to that group. These detailed records include unique user IDs and their roles, which is necessary for accurate cost assignment.
What specific fields does the tool return when I use get_friends to list all contacts? +
It returns a comprehensive list of connections, including unique user identifiers (IDs) and names. These IDs are crucial if you need your agent to create an expense for someone not in your current primary groups.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.