AI Connector · MCP server

Splitr, inside your AI assistant

One connector for Claude, ChatGPT and any assistant that speaks the Model Context Protocol. Ask about balances in plain language, or have it log an expense for you after you approve it.

Available

Overview

The Splitr connector is a remote MCP server. Add it to your assistant, sign in with the Google account you use for Splitr, and the assistant can:

  • list your groups and your balance in each,
  • summarise a group: who owes whom, and the shortest way to settle,
  • search recent expenses,
  • show payments waiting for your confirmation,
  • add an expense, or record, confirm or reject a payment, after telling you exactly what it will save and getting your OK.

The numbers always match the app: the connector uses the same balance, settle-up, claims and money-formatting code as Splitr itself, and it can see and do exactly what you can in the app. Nothing more.

Status

Live

The connector is deployed and in use, with all nine tools (five read-only, four that write). It runs on Cloudflare Workers' free plan, so it costs nothing to use.

AssistantSupport
Claude (web, desktop, mobile)Works As a custom connector. Free plans allow one custom connector.
ChatGPTWorks As a connector in developer mode. Which plans get developer mode changes over time, so check your account.
Claude Code, Cursor, VS Code and other MCP clientsShould work Any client that supports remote Streamable HTTP servers with OAuth. Not individually tested.
GeminiVaries Depends on the Gemini product: some personal accounts have a Connected Apps option, Gemini Enterprise/Business admins can add servers, and Gemini CLI is an MCP client. Not yet confirmed by Google's own documentation.

Connect it

You'll need a Splitr account signed in with Google. Guest accounts ("continue without account") are turned away at sign-in. Switch to Google in the app's Profile screen first.

The connector's address (it must end in /mcp):

https://splitr-mcp.splitr.workers.dev/mcp

Claude

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it Splitr, paste the address above, and click Add.
  3. Click Connect. A window opens: check that the app is Splitr and that "Access goes to" shows splitr-mcp.splitr.workers.dev, then tap Sign in with Google to connect Splitr and pick your account.
  4. In a chat, turn Splitr on from the tools menu and ask away.

ChatGPT

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. Choose Create, name it Splitr, paste the address, and set Authentication to OAuth. Leave Client ID and secret empty: ChatGPT registers itself.
  3. Sign in with Google when asked, then pick Splitr from the tools in a new chat.

Claude Code and other MCP clients

claude mcp add --transport http splitr https://splitr-mcp.splitr.workers.dev/mcp

Then run /mcp in Claude Code to sign in. Other clients take the same URL as a "remote" or "Streamable HTTP" server.

Menu names in assistants change often. If a step doesn't match, look for "connectors", "integrations" or "MCP servers" in settings.

Tools

These are the actions the connector gives your assistant. Amounts are always in each group's own currency, and amounts in different currencies are never added together.

Read-only Safe to call any time

ToolWhat it does
list_groupsYour groups: code, currency, number of people, and your net balance in each.
get_group_summaryOne group by name, partial name or code (asks you when a name matches several): people, balances, and "who pays whom".
list_expensesRecent expenses in a group, newest first, with your share. Filter by text in the description or payer. Shows 10 by default, up to 50.
my_balancesAcross all groups: who you owe and who owes you, per person and per currency.
list_pending_paymentsPayments waiting for you to confirm, and yours waiting on others. Optionally for one group.

Write Asks before saving

Assistants ask you before using these. Each one saves exactly what the app would, follows the same rules, and replies with exactly what was saved.

ToolWhat it does
add_expenseAdds an expense: who paid (default: you), split equally between everyone or named people, or by exact shares. Split to the cent in the group's currency, and checked like the app checks it.
record_paymentRecords a payment from the group's "who pays whom" plan, in full or in part, up to what's owed. It stays pending until the receiver confirms, just like in the app.
confirm_paymentConfirms a pending payment made to you.
reject_paymentRejects a pending payment made to you that didn't happen. Marked as destructive, so assistants take extra care.

There's deliberately no tool to delete or edit groups or expenses, cancel payments, or join a group. Those stay in the app, where deletes come with an Undo.

Example prompts

  • "What do I owe in the Goa Trip group?"
  • "Across all my groups, who owes me the most?"
  • "Show the last 10 expenses in Flat 4B with 'groceries'"
  • "Add ₹1,200 for dinner in Goa Trip, paid by me, split equally"
  • "Split $90 for the cab between me, Sam and Alex"
  • "Record that Priya paid me ₹500"
  • "Any payments I need to confirm?"

Security & privacy

  • It acts as you, never as an admin. There's no admin key or service account. Every request carries your own short-lived Firebase sign-in token, so Splitr's server-side security rules apply exactly as in the app. The connector can't see groups you're not in. Automated tests against the real rules prove it.
  • Sign-in stays with Google. You sign in on a Splitr page using Google. Your assistant never sees your password or your Google account.
  • Encrypted, minimal storage. Access tokens are stored only as hashes. Your Firebase sign-in token is encrypted with a key that only your assistant's token can unlock. The connector keeps no copy of your groups or expenses.
  • You approve every change. Write tools are flagged so assistants ask first, and the connector tells them to show you exactly what will be saved.
  • Turn it off any time. Disconnect Splitr in your assistant's settings and access ends. Signing out of Google everywhere, or deleting your Splitr account, also cuts it off at the next refresh.

Your assistant provider's own privacy terms cover what it does with the answers it receives. See Privacy for details.

Architecture

For developers, here's how it fits together. The source is in mcp/ in the Splitr repo.

Assistant ──OAuth 2.1 (DCR / CIMD, PKCE)──▶ Worker /authorize ──▶ "Sign in with Google" (Firebase Auth)
    │                                              └─ Firebase refresh token → encrypted in the OAuth grant
    │
    └──MCP (Streamable HTTP) + access token──▶ Worker /mcp
                                                   │  refresh token → ID token (cached ~55 min)
                                                   └─ Firestore REST as the user ──▶ firestore.rules decide
  • Runtime: Cloudflare Workers (free plan) with @cloudflare/workers-oauth-provider and the MCP TypeScript server SDK. Stateless: every request builds a fresh server bound to that person, so no Durable Objects are needed.
  • Shared logic: imports settlement.ts, claims.ts, payments.ts and money.ts straight from the app, so balances can't drift.
  • Tested with unit tests (names, claims, balances, currencies, the exact writes), integration tests on the Auth + Firestore emulators, and the MCP Inspector.

Want to run your own? See Developers → MCP server.

FAQ

Does the connector cost anything?

No. It runs on Cloudflare's and Firebase's free plans, like the app.

Can the assistant delete or edit my expenses?

No. There are no delete or edit tools. It can add expenses and record, confirm or reject payments, and only after you approve each one.

Why can't I connect a guest account?

Guest accounts live only on one device, so there's no way to sign in to them from somewhere else. Switch to Google in the app's Profile screen, then connect.

Adding the connector fails straight away

Check that the address ends in /mcp. The address without it won't work as a connector.

The assistant asks me to reconnect

That happens after you sign out of Google everywhere or your sign-in expires. Click Connect again and sign in. Nothing in Splitr is lost.

The assistant picked the wrong group

Use the group's exact name, or its 6-character code. When a name matches more than one group, the connector tells the assistant to check with you.