splitwise-mcp

# Splitwise MCP Server [](https://modelcontextprotocol.io) [](https://pypi.org/project/splitwise-mcp/) A Model Context Protocol (MCP) server that integrates with [Splitwise](https://splitwise.com). Connect your AI assistant (Claude, Cursor, etc.) to manage Splitwise expenses using natural language — with voice support! ## How It Works ```mermaid flowchart LR Client[Claude / Cursor] -->|MCP| Server[splitwise-mcp] Server -->|audio| Deepgram[Deepgram STT] Deepgram -->|text| Gemini[Gemini 3 Flash] Gemini -->|action| Splitwise[Splitwise API] ``` ## Features | Tool | Description | |------|-------------| | `voice_command` | Send audio → Deepgram transcribes → Gemini processes → Splitwise executes | | `text_command` | Send text → Gemini processes → Splitwise executes | | `add_expense` | Add expenses with support for groups, percentages, exclusions, and specific payers | | `delete_expense` | Delete an expense by ID | | `list_friends` | List your Splitwise friends | | `configure_splitwise` | Configure API credentials | | `login_with_token` | Login with OAuth2 token | **Smart Name Matching**: If Deepgram transcribes "Humeet" but your friend is "Sumeet", Gemini will ask for clarification instead of guessing. ### Advanced Splits - **Percentages**: "Split 40% for me and 60% for Alice" - **Groups**: "Add to Apartment group" (Auto-fetches members) - **Exclusions**: "Add to Apartment but exclude Bob" - **Payer**: "Alice paid $50" - **Deletion**: "Delete expense 12345" ## Installation ### Option 1: Install from PyPI (Recommended) ```bash pip install splitwise-mcp ``` ### Option 2: Install from Source 1. **Clone the repository**: ```bash git clone https://github.com/hubshashwat/the-splitwise-mcp.git cd the-splitwise-mcp ``` 2. **Create and activate a virtual environment**: ```bash python3 -m venv .venv source .venv/bin/activate …