Skip to main content

MCP server for Splitwise - create and manage expenses, splits, and groups directly from Claude

Project description

gr-splitwise-mcp

MCP server for Splitwise. Create and manage expenses, splits, and groups directly from Claude — no manual entry.

Tools

Tool What it does
list_groups List all your Splitwise groups with IDs
list_group_members List members of a group with user IDs
create_group Create a new group and add members
create_expense Create an expense with per-user splits, date, and notes
update_expense Update any field on an existing expense
delete_expense Delete an expense by ID

Setup

1. Get your Splitwise API key

Go to https://secure.splitwise.com/apps, create a new app, and copy the API key.

2. Add to Claude Desktop

{
  "mcpServers": {
    "splitwise": {
      "command": "uvx",
      "args": ["gr-splitwise-mcp"],
      "env": {
        "SPLITWISE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Add to Claude Code

claude mcp add splitwise -e SPLITWISE_API_KEY=your-api-key-here -- uvx gr-splitwise-mcp

Usage examples

Create an expense with a custom split:

Create a Splitwise expense for dinner at Zaika, $259.59, in group 97230678.
I paid. Split 75% to me (user 94211279) and 25% to Suhas (user 24465843).
Date: May 2, notes: "Niagara Falls trip dinner"

Create a group:

Create a Splitwise group called "Barcelona Trip 2026", type trip,
and add user 24465843 as a member.

Update an expense date/notes:

Update expense 4451638821 — set date to 2026-03-19 and notes to "Turo car rental booking"

Notes

  • Dates are automatically normalized to noon UTC to avoid timezone display issues in the Splitwise app
  • All splits must sum exactly to the total cost
  • Use list_groups and list_group_members to find IDs before creating expenses

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gr_splitwise_mcp-0.1.3.tar.gz (4.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gr_splitwise_mcp-0.1.3-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

File details

Details for the file gr_splitwise_mcp-0.1.3.tar.gz.

File metadata

  • Download URL: gr_splitwise_mcp-0.1.3.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for gr_splitwise_mcp-0.1.3.tar.gz
Algorithm Hash digest
SHA256 aed1b9699d339eb680514d2b67ffddecfaf2daeb32ca779321849ae3103ad38a
MD5 f9cafd6bc94f9770e77b7b4049bae927
BLAKE2b-256 07528947f7e7135c0aee2108bb23ce4db506b4447321647689d78f2aa292fb02

See more details on using hashes here.

File details

Details for the file gr_splitwise_mcp-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for gr_splitwise_mcp-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8313a70d34b7985bbc6eaff702c082ea9e1c0d81f0140207311be4beb8a52396
MD5 fb9fd843e887ab02b1a3a1e790a12896
BLAKE2b-256 b1a65ab9d6bc234c59bd4c79bedb1b11898959533ea4d64c51b57a62cc22ef21

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page