How to Use the Splitwise MCP in Windsurf

Q: How do I check my current balance with Splitwise using Windsurf?

Your AI client uses getcurrentuser to pull your details and then aggregates data from all associated groups. It shows you exactly who owes you money right now.

Q: Can I list all my current shared expense groups with Splitwise using Windsurf?

Yep. Just invoke getgroups. This immediately provides a comprehensive list of every group ledger you're involved in, making it easy to pick the right one for your task.

Q: What if I need friend details for Splitwise reporting in Windsurf?

Use getfriends first. It gives a list of all contacts. Then, pass an individual ID into getfriend to get the specific details you need for your report.

Q: Does Splitwise handle expense history well in Windsurf?

Absolutely. The getexpenses tool lets you list all past transactions associated with a group or user, giving you full visibility into the money trail.

Manage shared expenses and group debts inside your IDE with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Splitwise MCP to Windsurf

Create your Vinkius account to connect Splitwise to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Splitwise with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Building Expense Reports for Windsurf

The `create_expense` tool lets you log a new cost and distribute it immediately. You pass in all the necessary details, including costs, descriptions, and which users paid specific shares. You don't have to manually check balances; just run this function. It logs the expense and updates everyone’s debt structure right away.

Checking Friend Status via MCP Server

Need to know who you're splitting costs with? Use `get_friends` to list every person in your network. You can then drill down into a specific connection using `get_friend`. This gives you the names and details required before you write any code that depends on group membership.

Retrieving Group Details with Windsurf

To understand a shared financial situation, start by calling `get_groups`. This lists every group account you're attached to. You can then pass the group ID into `get_group` for all the specifics. This helps your agent build an accurate context map before attempting any complex debt calculations.

Setup guide

Set up Splitwise MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Splitwise MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Splitwise payment history." If connected, Cascade will call the Splitwise tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "splitwise-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Splitwise now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Splitwise MCP in Windsurf

Your AI client uses `get_current_user` to pull your details and then aggregates data from all associated groups. It shows you exactly who owes you money right now.

Yep. Just invoke `get_groups`. This immediately provides a comprehensive list of every group ledger you're involved in, making it easy to pick the right one for your task.

Use `get_friends` first. It gives a list of all contacts. Then, pass an individual ID into `get_friend` to get the specific details you need for your report.

Absolutely. The `get_expenses` tool lets you list all past transactions associated with a group or user, giving you full visibility into the money trail.

This server handles financial records and user identity data. Specifically, it manages expense details (cost, description) and associated user IDs within a group context.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript