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

Uploaded Python 3

File details

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

File metadata

  • Download URL: gr_splitwise_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 3.5 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.0.tar.gz
Algorithm Hash digest
SHA256 56edd295bb698bbdf422345f69b63c31f621f333eeb686691ef4fab23cd49f89
MD5 b0f787286e39951ddbf2bd1773842aa3
BLAKE2b-256 abf2c77b450d9f7d8b2aa4cab0d6fc81779f3b0904db31d320a0999d6c9266ee

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gr_splitwise_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 77271c8c67ab3011acc0a97d4032c0457deba865aebaffe719c2bb1733ecb9de
MD5 3e8266791ac24af29ca8000b105e50b9
BLAKE2b-256 40595dc09c4333e1611b0edfba06b12faf101e657ff6ec8d8988ac8e38960ca5

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