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.1.tar.gz (4.0 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.1-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: gr_splitwise_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 4.0 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.1.tar.gz
Algorithm Hash digest
SHA256 1728bf49d061511d7419f33e3887bdc9f209b52d9e3098c869526c13cad3786b
MD5 ed6544e639d655d4110a7636ebed93f8
BLAKE2b-256 ce749585a21a16ae6a76217b384c1663ce9c78d66ca9c067635778e46c34129f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gr_splitwise_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cf17d0aa377b209b3ad86adb1e513d6a93f855f28fad1296082556a27cdf9a2a
MD5 5cc559316d2d6f3994676d1d6f88e4db
BLAKE2b-256 8554944c2ae5f81d7fdf877e42dd84d8393785c67d0c22e1c5dc9bf6ec6a7df5

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