Splitwise를 위한 Model Context Protocol (MCP) 서버는 AI 에이전트를 사용하여 비용, 그룹 및 자연 언어로 친구를 관리할 수 있습니다.

특징

• Full API Access: 비용, 그룹, 친구 및 의견 관리.
• Natural Language Resolution: 이름 (“John” -> “John Smith”) 및 그룹에 대한 Fuzzy 매칭. -Dual Auth: OAuth 2.0(추천)과 API 키 모두 지원
• Smart Caching: 범주 및 통화와 같은 정적 데이터에 대한 성능을 최적화합니다.

설치

구성

자세한 인증 및 구성 지침에 대한 SETUP.md를 참조하십시오.

빠른 Config

포함 된 설정 스크립트를 실행:

키가 제공되고, 모든 세를 추가 mcp.json:

** 당신의 Auth 열쇠를 얻으십시오 ** https://secure.splitwise.com/apps.에서 앱을 등록함으로써 소비자 키와 비밀을 얻을 수 있습니다.

**IMPORTANT: ** 가상 환경 사용? venv 또는 Conda 환경에서 패키지를 설치하면 config에서 python 실행할 수 있는 absolute path를 사용해야 합니다. · ·

세부사항을 위해 SETUP.md를 보십시오.

사용법

서버는 Splitwise 데이터와 자연 언어 상호 작용을 가능하게 합니다.

예금:

• “내 현재 균형은 무엇입니까?”

Splitwise MCP Server

A Model Context Protocol (MCP) server for Splitwise, enabling AI agents to manage expenses, groups, and friends with natural language.

Features

• Full API Access: Manage expenses, groups, friends, and comments.
• Natural Language Resolution: Fuzzy matching for names (“John” -> “John Smith”) and groups.
• Dual Auth: Supports both OAuth 2.0 (recommended) and API Keys.
• Smart Caching: Optimizes performance for static data like categories and currencies.

Installation

# From PyPI (when published)
pip install splitwise-mcp-server

# From Source
git clone https://github.com/tarunn2799/splitwise-mcp-server
cd splitwise-mcp-server
pip install -e .

Configuration

See SETUP.md for detailed authentication and configuration instructions.

Quick Config

Run the included setup script:

python -m splitwise_mcp_server.oauth_setup

Use the keys provided there, and add all three to your mcp.json:

{
  "mcpServers": {
    "splitwise": {
      "command": "python",
      "args": ["-m", "splitwise_mcp_server"],
      "env": {
        "SPLITWISE_OAUTH_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Get your Auth Keys You can get your Consumer Key and Secret by registering an app at https://secure.splitwise.com/apps.

IMPORTANT: Using a Virtual Environment? If you installed the package in a venv or Conda environment, you must use the absolute path to the python executable in your config.

"command": "/absolute/path/to/venv/bin/python"

See SETUP.md for details.

Usage

The server enables natural language interactions with your Splitwise data.

Examples:

• “What’s my current balance?”
• “Split a $50 dinner with Sarah.”
• “Use the receipt I uploaded to split the dinner between Manav and me.”
• “Show me expenses from last month.”
• “Create a group called ‘Ski Trip’ with Mike.”

Tools

See TOOLS.md for detailed documentation.

User Tools

• get-current-user: Get authenticated user information
• get-user: Get information about a specific user

Expense Tools

• create-expense: Create a new expense with splits
• get-expenses: List expenses with optional filters
• get-expense: Get detailed expense information
• update-expense: Update an existing expense
• delete-expense: Delete an expense

Group Tools

• get-groups: List all groups
• get-group: Get detailed group information
• create-group: Create a new group
• delete-group: Delete a group
• add-user-to-group: Add a user to a group
• remove-user-from-group: Remove a user from a group

Friend Tools

• get-friends: List all friends
• get-friend: Get detailed friend information

Resolution Tools

• resolve-friend: Fuzzy match friend names to user IDs