How to Use the Splitwise MCP in Cursor

Q: How do I calculate a debt in Splitwise using Cursor?

You'll use getgroup to pull the current balance. Then, you write code that processes those JSON results into your desired output format.

Q: Can I list all expenses for testing in Splitwise with Cursor?

Yes, call getexpenses. The agent will return a list of transactions, and you can iterate over them right inside the code block to test your logic.

Q: What if I need friend details for validation in Splitwise with Cursor?

Use getfriend first. The API response gives you enough context about the person so you can ensure they are included in expense calculations.

Q: Is it possible to delete an expense in Splitwise using Cursor?

Absolutely. You just write a function that calls deleteexpense and passes the appropriate transaction ID. It's straightforward to implement cleanup code.

Q: What data does the Splitwise server touch when I query for privacy concerns with Cursor?

The primary data type is Expense Records. When you call getexpenses or createexpense, your code interacts directly with these specific records.

Write code that uses real Splitwise balances directly in Cursor for live context.

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 Cursor

Create your Vinkius account to connect Splitwise to Cursor — 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Retrieve current group and expense data.

Need a balance check while you're mid-function? Just call `get_group` to grab the latest ledger info. You can then use that JSON response directly in your code block. Alternatively, calling `get_expenses` lets you loop through all past transactions and build complex financial logic.

Get specific friend or user details.

Before calculating a share, you might need to confirm the recipient's ID. Use `get_friend` for quick lookups on contacts, or go deeper with `get_user(id)` to pull full user profiles. This ensures your code uses accurate IDs when writing payment calculations.

Handle expense creation programmatically.

If your script detects a new cost, don't manually enter it. Use `create_expense` and feed the details directly into the API call within your code. You just need to structure the JSON right. This means your application has live data input capabilities without leaving your coding environment.

Setup guide

Set up Splitwise MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Splitwise MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Splitwise transactions." If the MCP tools are loaded correctly, Cursor will call the Splitwise tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

You'll use `get_group` to pull the current balance. Then, you write code that processes those JSON results into your desired output format.

Yes, call `get_expenses`. The agent will return a list of transactions, and you can iterate over them right inside the code block to test your logic.

Use `get_friend` first. The API response gives you enough context about the person so you can ensure they are included in expense calculations.

Absolutely. You just write a function that calls `delete_expense` and passes the appropriate transaction ID. It's straightforward to implement cleanup code.

The primary data type is Expense Records. When you call `get_expenses` or `create_expense`, your code interacts directly with these specific records.

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