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

Uploaded Python 3

File details

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

File metadata

  • Download URL: gr_splitwise_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 4.2 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.2.tar.gz
Algorithm Hash digest
SHA256 0042f8e7af28c5c7f426284e2594c73c5068d308d7406eab045e403ece0899cd
MD5 0662dfb36d4b595e088e48db41e45080
BLAKE2b-256 01fd82e0fa908ef317fd996270ceeb39d00dc10c084b27fb5109e8f93f1df862

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gr_splitwise_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 57750cdc87786f4164969614f9368cd058b2fe63b18b1e3877b87495bbe3b1d4
MD5 a2924da71529ac65a8f3cb112fa99c0e
BLAKE2b-256 65583a86c8b802f39447827eb0f95d23b8830da294937e04940fc586f6fbfc20

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