Back to Browse
Free
Server data from the Official MCP Registry
Splitwise expense and group management for Claude — shared expenses, settle up, friends
About
Splitwise expense and group management for Claude — shared expenses, settle up, friends
Security Report
10.0
Low Risk10.0Low RiskValid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (12/12 approved).
4 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Your Splitwise API key (splitwise.com/apps/api)Required
Environment variable: SPLITWISE_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-chrischall-splitwise-mcp": {
"env": {
"SPLITWISE_API_KEY": "your-splitwise-api-key-here"
},
"args": [
"-y",
"splitwise-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Splitwise MCP
A Model Context Protocol server that connects Claude to Splitwise, giving you natural-language access to your expenses, groups, friends, and balances.
[!WARNING] AI-developed project. This codebase was entirely built and is actively maintained by Claude Code. No human has audited the implementation. Review all code and tool permissions before use.
What you can do
Ask Claude things like:
- "What do I owe?"
- "Add a $50 dinner expense to the vacation group"
- "Split this hotel bill 60/40 with Sarah"
- "Who's in the trip group?"
- "Add Meredith to the household group"
- "Show me recent expenses"
- "Delete that duplicate expense"
Requirements
- Claude Desktop or Claude Code
- Node.js 20.6 or later
- A Splitwise account and API key
Installation
Option A -- npx (recommended)
npx -y splitwise-mcp
Add to your Claude config (.mcp.json or Claude Desktop config):
{
"mcpServers": {
"splitwise": {
"command": "npx",
"args": ["-y", "splitwise-mcp"],
"env": {
"SPLITWISE_API_KEY": "your-api-key-here"
}
}
}
}
Option B -- from source
git clone https://github.com/chrischall/splitwise-mcp.git
cd splitwise-mcp
npm install
npm run build
Add to Claude Desktop config:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"splitwise": {
"command": "node",
"args": ["/absolute/path/to/splitwise-mcp/dist/index.js"],
"env": {
"SPLITWISE_API_KEY": "your-api-key-here"
}
}
}
}
Getting your API key
- Go to secure.splitwise.com/apps/register
- Register an app (name and description can be anything)
- Copy the API key from the app detail page
Credentials
| Env var | Required | Notes |
|---|---|---|
SPLITWISE_API_KEY | Yes | API key from splitwise.com/apps/register |
Available tools
20 tools across 5 domains. All tools are prefixed sw_.
User
| Tool | What it does |
|---|---|
sw_get_current_user | Get the authenticated user's profile |
sw_get_user | Get another user's profile by ID |
Groups
| Tool | What it does |
|---|---|
sw_list_groups | List all groups with members |
sw_get_group | Group details including members and balances |
sw_create_group | Create a new group |
sw_delete_group | Soft-delete a group |
sw_undelete_group | Restore a deleted group |
sw_add_user_to_group | Add a user to a group |
sw_remove_user_from_group | Remove a user from a group |
Friends
| Tool | What it does |
|---|---|
sw_list_friends | List all friends |
sw_create_friend | Add a friend by email |
sw_delete_friend | Remove a friendship |
Expenses
| Tool | What it does |
|---|---|
sw_list_expenses | List or search expenses with filters |
sw_get_expense | Full details of a single expense |
sw_create_expense | Create an expense (equal or custom split) |
sw_update_expense | Edit an existing expense |
sw_delete_expense | Soft-delete an expense |
sw_undelete_expense | Restore a deleted expense |
sw_get_comments | Get comments on an expense |
sw_create_comment | Add a comment to an expense |
sw_delete_comment | Delete a comment |
Utilities
| Tool | What it does |
|---|---|
sw_get_notifications | Recent activity feed |
sw_get_categories | Expense category list |
sw_get_currencies | Supported currency codes |
Troubleshooting
"SPLITWISE_API_KEY is required" -- set the environment variable in your MCP config or a .env file.
429 rate limit -- Splitwise has undocumented rate limits. Wait a moment and retry.
Tools not appearing in Claude -- go to Claude Desktop > Settings > Developer to see connected servers. Make sure you fully quit and relaunched after editing the config.
Development
npm test # run the test suite (vitest)
npm run build # compile TypeScript -> dist/
Project structure
src/
client.ts Splitwise API client (auth, request handling)
index.ts MCP server entry point
tools/
user.ts sw_get_current_user, sw_get_user
groups.ts group CRUD and membership
friends.ts friend list and management
expenses.ts expense CRUD, comments
utilities.ts notifications, categories, currencies
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
4
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
425
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
59
Installs
10.0
Security
5.0
Local