Log inSubmit server
Splitwise MCP logo

Splitwise MCP

Manage Splitwise users, groups, friends, expenses, comments, balances, notifications, currencies, and receipts through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Splitwise MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "splitwise-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "splitwise-mcp"
      ],
      "env": {
        "SPLITWISE_API_KEY": "YOUR_VALUE_HERE",
        "SPLITWISE_OUTPUT_DIR": "YOUR_VALUE_HERE",
        "MCP_CONFIRM_MODE": "YOUR_VALUE_HERE",
        "MCP_CONFIRM_TTL_SECONDS": "YOUR_VALUE_HERE",
        "MCP_CONFIRM_SECRET": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 31 tools correctly (Today).

Overview

The splitwise-mcp MCP server connects an MCP client to your Splitwise account through Splitwise’s public API. It supports reading and changing users, groups, friends, expenses, comments, balances, notifications, categories, currencies, and receipts. Write operations use confirmation flows, while receipt downloads authenticate through the server rather than direct receipt URLs. Reach for it when an agent needs to inspect or update personal Splitwise data from Claude Desktop or Claude Code.

Use cases

  • Inspect group balances and determine what you owe
  • Create equal or custom-split expenses
  • Add or remove friends and group members
  • Search expenses and review recent activity
  • Download and extract text from receipts

Key features

  • Manage Splitwise groups, members, and balances
  • Create, search, edit, delete, and restore expenses
  • Add comments to expenses
  • Manage friends and user profile settings
  • Download authenticated receipts with PDF text extraction
  • Require confirmation for data-changing operations

Tools31

What Splitwise MCP lets your agent do. Expand a tool for its parameters.

Verified live~9.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 42d

What it can do

From the 31 tools this server returned when we ran it; 31 declare their own safety hints.

Runs commands · 1Can delete or modify data · 16Handles credentials · 19Makes network requests · 31Read-only tools · 14
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age225 days
Maintainers1

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · splitwise-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads3.5kPackage downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed31Callable tools this server registers over MCP.

How Splitwise MCP works

What splitwise-mcp MCP server does

The splitwise-mcp MCP server exposes Splitwise account operations as MCP tools. It can retrieve the authenticated user and other users, list friends, inspect groups and balances, and create, update, soft-delete, or restore groups, friendships, and expenses. Expense support includes equal or custom splits, filtering, full expense details, comments, and recent activity.

The server also provides utility access to Splitwise categories and supported currency codes. Its receipt tool downloads an expense receipt using the server’s authenticated request, returning the content inline, extracting PDF text, writing it to a file, or combining these outputs as supported by the request.

How it works

The splitwise-mcp MCP server runs as a local Node.js MCP process and calls Splitwise’s official Developer API with the account owner’s API key. It does not provide access to other accounts or bypass Splitwise permissions. A health-check tool separately reports whether the API key and Splitwise service can be reached, including which check failed.

Operations that change data require confirmation because they can notify other people in Splitwise. Clients with confirmation prompts, such as Claude Code, show a prompt. Clients without that capability use a preview and confirmation token flow; the initial call makes no change, and a later call must provide the valid token without altering the request.

Setup and configuration

Use Node.js 22 or later, a Splitwise account, and an API key created through Splitwise’s app registration page. The package can run with npx -y splitwise-mcp, or you can clone the repository, install dependencies, build it, and run the generated Node entry point. Add the command and environment settings to the MCP configuration for Claude Desktop or Claude Code.

Required configuration is SPLITWISE_API_KEY. SPLITWISE_OUTPUT_DIR optionally restricts where receipt files are written and defaults to the server’s current working directory. Confirmation behavior can be configured with MCP_CONFIRM_MODE, MCP_CONFIRM_TTL_SECONDS, and MCP_CONFIRM_SECRET.

Tools and capabilities

The splitwise-mcp MCP server groups its tools into six areas:

  • User tools for profiles, API reachability, and selected profile updates.
  • Group tools for membership, balances, creation, deletion, and restoration.
  • Friend tools for listing, adding by email, and removing friendships.
  • Expense tools for searching, splitting, editing, deleting, restoring, and commenting.
  • Receipt tools for authenticated image or PDF retrieval and optional text extraction.
  • Utility tools for notifications, categories, and currencies.

Limitations and notes

The project states that its code was built and is maintained by Claude Code and has not been audited by a human; review the implementation and requested permissions before use. Splitwise Developer Terms govern API usage, including rate limits and restrictions on competing or commercial use. Keep the API key private and do not commit it to source control or expose it in shared clients.

Receipt URLs found in expense data are not public and should not be fetched directly without authentication. Receipt files are written to the server’s filesystem, which may differ from the caller’s filesystem when the server runs in a container or hosted environment; use inline output when that distinction matters.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Splitwise MCP

splitwise-mcp is an MCP server that connects Claude to Splitwise through the official API. Its main tools manage users, groups, friends, expenses, comments, notifications, categories, currencies, and authenticated receipt downloads. It uses the user’s Splitwise API key and supports both read operations and confirmed account changes.

Install it with Node.js 22 or later by running `npx -y splitwise-mcp`, then add that command to your Claude MCP configuration with `SPLITWISE_API_KEY`. You can also clone the repository, run `npm install` and `npm run build`, and configure Node to launch `dist/index.js`.

The server requires `SPLITWISE_API_KEY`, obtained by registering an app with Splitwise. `SPLITWISE_OUTPUT_DIR` is optional for receipt output. Confirmation behavior can also use `MCP_CONFIRM_MODE`, `MCP_CONFIRM_TTL_SECONDS`, and `MCP_CONFIRM_SECRET`.

Yes, splitwise-mcp supports Claude Desktop through its MCP configuration. On clients without a confirmation prompt, including Claude Desktop, write calls first return a preview and confirmation token; a later call with the valid token performs the change.

Use `sw_get_receipt`; it downloads the receipt with the server’s authenticated credentials. The tool can return receipt data inline, extract text from PDFs, and write output to the server filesystem. Direct receipt URLs from an expense are not public and should not be fetched unauthenticated.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSplitwise MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/splitwise-mcp?style=directory)](https://allmcps.com/mcp/splitwise-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/splitwise-mcp"><img src="https://allmcps.com/api/badge/splitwise-mcp?style=directory" alt="Splitwise MCP on AllMCPs" /></a>