Splitwise MCP Server

A Model Context Protocol (MCP) server for Splitwise. This tool allows AI models like Claude to manage your expenses, groups, and friends directly via standard I/O.

Features

• Full API Coverage: 28 tools covering users, groups, friends, and expenses.
• Smart Expense Creation: Specialized add_shared_expense tool for simplified splitting logic.
• npx Ready: Zero-installation usage for quick deployment.
• Secure: Uses environment variables for API key management.

Prerequisites

1. Splitwise API Key: Obtain yours from the Splitwise Developer Portal.
2. Node.js: Version 16 or higher installed.

Quick Start (Using npx)

Run the server instantly without installation:

export SPLITWISE_API_KEY=your_api_key_here
npx @mrpirated/splitwise-mcp

Configuration

Claude Desktop

Add this to your claude_desktop_config.json (usually located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "splitwise": {
      "command": "npx",
      "args": ["-y", "@mrpirated/splitwise-mcp"],
      "env": {
        "SPLITWISE_API_KEY": "YOUR_SPLITWISE_API_KEY"
      }
    }
  }
}

Claude Code

Easily add the server to Claude Code:

claude mcp add @mrpirated/splitwise-mcp --env SPLITWISE_API_KEY=YOUR_KEY

Available Tools

💸 Expenses

• search_expenses: Find expenses by description (client-side search).
• add_shared_expense: Simplified helper for common split scenarios.
• get_expenses: List recent expenses with filters.
• create_expense: Advanced expense creation.
• update_expense, delete_expense, undelete_expense.

👥 Groups & Friends

• get_groups, get_group, create_group, delete_group.
• add_user_to_group, remove_user_from_group.
• get_friends, get_friend, create_friend, delete_friend.

👤 User & Info

• get_current_user, get_user, update_user.
• get_notifications, get_currencies, get_categories.
• get_comments, create_comment, delete_comment.

Development

1. Clone the repository:

   git clone https://github.com/mrpirated/splitwise-mcp-node.git
   cd splitwise-mcp-node

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. Run locally:

   npm start

License

This project is licensed under the MIT License.