Splitwise MCP Server

Gestiona gastos de Splitwise en inglés sencillo a través de Claude AI: añade gastos, consulta saldos y liquida cuentas sin abrir la aplicación.

GitHub

Prueba este MCPPatrocinado

Documentación

Splitwise MCP Server — Controla Splitwise en lenguaje natural

"Añade una cena de ₩45,000, pagué yo, dividir en partes iguales." Hecho. Sin app. Sin tocar nada. Sin matemáticas.

Por qué lo construí

Estaba a punto de irme de viaje con amigos y ya daba pavor llevar el control de gastos.

Ya sabes cómo va — alguien paga la cena, otro coge el taxi, otro cubre el depósito del hotel. Para el segundo día, ya has perdido la cuenta. Así que abres Splitwise, tocas cuatro pantallas, escribes el importe, seleccionas a las personas, eliges quién pagó, pulsas guardar. Y luego lo haces otra vez para lo siguiente. Y otra vez.

Pensé: Ya uso Claude para todo lo demás. ¿Y si pudiera simplemente contarle lo que ha pasado y que él se encargue de Splitwise por mí?

Así que lo construí en un fin de semana. Es un pequeño servidor Python que conecta Claude AI directamente con tu cuenta de Splitwise. Hablas con Claude como un humano, y él hace el trabajo de Splitwise por ti — añadir gastos, consultar saldos, registrar liquidaciones, corregir errores.

Sin cambiar de app. Sin entrada manual. Solo di lo que ha pasado.

Cómo se siente usarlo

You:    "We had a group dinner for ₩65,000. I paid. Split equally."
Claude: Done! Added "Group dinner" for ₩65,000.00 (KRW), split equally
        among 4 members. Each person owes ₩16,250.

You:    "What does everyone owe in the trip group?"
Claude: Here are the current balances:
        • Raj owes you ₩32,500
        • Priya owes you ₩16,250
        • Sam is owed ₩8,000 by the group

You:    "Record that Raj paid me back ₩30,000."
Claude: Payment of ₩30,000 recorded. Raj's balance updated.

You:    "Wait, that dinner was actually ₩72,000. Can you fix it?"
Claude: Updated! "Group dinner" changed to ₩72,000. Shares recalculated.

Funciona con cualquier moneda que soporte Splitwise — USD, EUR, INR, KRW, JPY y más.

Cómo funciona (la versión simple)

You talk to Claude
       ↓
Claude understands what you want
       ↓
Claude calls this MCP server
       ↓
This server calls the Splitwise API
       ↓
Your Splitwise account updates instantly
       ↓
Everyone's app reflects the change

MCP (Model Context Protocol) es una forma estándar de dar a Claude acceso a herramientas externas. Este proyecto es la "herramienta Splitwise" — un puente entre Claude y tu cuenta de Splitwise.

Consulta architecture.md para ver un diagrama detallado de cómo se conecta todo.

Lo que puedes hacer

Pregúntale a Claude	Qué ocurre
"Lista mis grupos"	Muestra todos tus grupos de Splitwise con sus miembros
"¿Quién debe qué en [grupo]?"	Muestra todos los saldos
"Añade un almuerzo de $52, pagué yo, dividir en partes iguales"	Crea el gasto
"Añade hotel de $240 — pagué $120, Alex $80, Sam $40"	División exacta
"Divide el taxi de $35 50/30/20"	División porcentual
"Registra que Alex me devolvió $20"	Pago de liquidación
"Elimina ese último gasto"	Lo elimina
"Cambia la cena a $60"	Actualiza y recalcula

Configuración

Lo que necesitarás

Python 3.10+ (python3 --version para comprobarlo)
Una cuenta de Splitwise + clave API de secure.splitwise.com/apps
Claude Desktop o Claude Code

Paso 1: Clona e instala

git clone https://github.com/yourusername/splitwise-mcp.git
cd splitwise-mcp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Paso 2: Añade tu clave API

Crea un archivo llamado .env en la carpeta del proyecto:

SPLITWISE_API_KEY=paste_your_key_here

Dónde conseguir tu clave:

Ve a secure.splitwise.com/apps
Haz clic en "Register your application"
Rellena cualquier nombre (p. ej., "My MCP Server")
Copia la API Key en tu archivo .env

Paso 3: Conecta con Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "splitwise": {
      "command": "/full/path/to/venv/bin/python3",
      "args": ["/full/path/to/splitwise_server.py"]
    }
  }
}

Reinicia Claude Desktop. Verás un icono de martillo — eso significa que las herramientas están conectadas.

Paso 4 (Opcional): Aloja en un servidor para acceso 24/7

¿Quieres que funcione incluso cuando tu portátil está apagado? Despliégalo en cualquier VPS (yo uso Hostinger).

Consulta DEPLOY.md para la guía completa paso a paso.

Una vez alojado, conecta Claude Desktop mediante:

{
  "mcpServers": {
    "splitwise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://YOUR_SERVER_IP:8000/mcp", "--allow-http"]
    }
  }
}

Todas las herramientas disponibles

Herramienta	Qué hace
`get_current_user`	Tu perfil de Splitwise
`list_currencies`	Todas las monedas que soporta Splitwise
`list_groups`	Todos tus grupos con IDs de miembros
`get_group`	Detalles del grupo — miembros, saldos, deudas
`list_expenses`	Gastos recientes en un grupo
`get_expense`	Detalles completos de un gasto
`create_expense`	Añadir gasto (división igual, exacta o porcentual)
`update_expense`	Editar descripción, coste, moneda o fecha
`delete_expense`	Eliminar un gasto
`create_payment`	Registrar una liquidación entre dos personas

Solución de problemas

Problema	Solución
Claude no ve las herramientas de Splitwise	Reinicia Claude Desktop después de editar la configuración
Error 401 Unauthorized	Comprueba que tu clave API en `.env` es correcta
"No module named mcp"	Activa tu venv: `source venv/bin/activate`
Servidor desconectado	Comprueba que el servidor está en ejecución: `sudo systemctl status splitwise-mcp`
Rutas incorrectas en la configuración	Usa rutas absolutas completas, no relativas

Estructura del proyecto

splitwise-mcp/
├── splitwise_server.py   ← The entire server (~500 lines, one file)
├── .env                  ← Your API key (never committed to git)
├── requirements.txt      ← Python dependencies
├── architecture.md       ← How everything connects
├── DEPLOY.md             ← How to host on a VPS
└── README.md             ← This file

Construido con

FastMCP — framework MCP para Python
Splitwise REST API v3
httpx — cliente HTTP
Alojado en Hostinger VPS (Ubuntu)

Construido por un desarrollador de Python por primera vez que solo quería dejar de registrar manualmente los gastos de viaje. Si yo pude construirlo, tú puedes usarlo.

Licencia

MIT — úsalo como quieras.