# Splitwise

```json
{
  "name": "Splitwise",
  "slug": "splitwise",
  "url": "https://composio.dev/toolkits/splitwise",
  "markdown_url": "https://composio.dev/toolkits/splitwise.md",
  "logo_url": "https://logos.composio.dev/api/splitwise",
  "categories": [
    "finance & accounting"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:26:49.209Z"
}
```

![Splitwise logo](https://logos.composio.dev/api/splitwise)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Splitwise MCP or direct API to split expenses, fetch group balances, add expenses, and settle up through natural language.

## Summary

Splitwise helps you split bills and expenses with friends and family. It makes it easy to track shared costs and settle up, so everyone stays on the same page.

## Categories

- finance & accounting

## Toolkit Details

- Tools: 27

## Images

- Logo: https://logos.composio.dev/api/splitwise

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Splitwise.
  - Setup:
    - Configure Oauth2 credentials for Splitwise.
    - Use the credentials when creating an auth config in Composio.
- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Splitwise.
  - Setup:
    - Configure Api Key credentials for Splitwise.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Add a new friend using their email
- Create a dinner expense split equally
- List all groups I'm part of
- Show categories for adding an expense

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `SPLITWISE_ADD_FRIEND` | Add Friend | Tool to add a new friend to Splitwise. Use when you have the friend's email and name details ready. |
| `SPLITWISE_ADD_USER_TO_GROUP` | Add User to Group | Tool to add a user to a group. Use when you need to add an existing Splitwise user to a specific group. Note: 200 OK does not indicate success; always check the response 'success' field. |
| `SPLITWISE_CREATE_COMMENT` | Create Comment | Tool to create a comment on a specific expense. Use when you need to add a comment or note to an existing expense. |
| `SPLITWISE_CREATE_EXPENSE` | Create Expense | Tool to create a new Splitwise expense. Use when you need to record a payment or bill in a group or between users. Provide exactly one of split_equally or users for shares — supplying both or neither causes a validation error and no expense is created. |
| `SPLITWISE_CREATE_FRIENDS` | Create Friends | Tool to add multiple friends at once to Splitwise. Use when you need to add several friends in a single operation. |
| `SPLITWISE_CREATE_GROUP` | Create Group | Tool to create a new group in Splitwise. Use when you need to create a group for tracking shared expenses. The current user is automatically added to the group. You can optionally add other members during creation. |
| `SPLITWISE_DELETE_COMMENT` | Delete Comment | Tool to delete a comment by its ID. Use after confirming you have a valid comment ID. |
| `SPLITWISE_DELETE_EXPENSE` | Delete Expense | Tool to delete an existing expense by its ID. Deletion is irreversible — no undelete capability exists. Use after confirming you have the correct expense ID. Inspect the response's `success` and `error` fields to verify deletion succeeded; failures (e.g., user lacks owner/participant permissions) are surfaced there. |
| `SPLITWISE_DELETE_FRIEND` | Delete Friend | Tool to delete an existing friend by ID. Use when you need to remove a friend relationship by its user ID. Call after confirming the correct friend ID. |
| `SPLITWISE_DELETE_GROUP` | Delete Group | Tool to delete a group and all associated records by its ID. Use when you need to permanently remove a group and its expenses. Call after confirming the correct group ID. |
| `SPLITWISE_GET_CATEGORIES` | Get Categories | Tool to retrieve expense categories. Use when you need to list available categories before creating an expense. |
| `SPLITWISE_GET_COMMENTS` | Get Comments | Tool to retrieve all comments associated with a specific expense. Use when you need to view comments on an expense, including both system-generated updates and user-authored messages. |
| `SPLITWISE_GET_CURRENCIES` | Get Currencies | Tool to retrieve a list of supported currencies. Use when you need to display or validate currency options. |
| `SPLITWISE_GET_CURRENT_USER` | Get Current User | Tool to retrieve information about the current authenticated user. Use when you need profile details of the logged-in user. |
| `SPLITWISE_GET_EXPENSE` | Get Expense | Tool to retrieve detailed information about a specific expense by ID. Use when you need to view expense details including participants, shares, and repayments. |
| `SPLITWISE_GET_EXPENSES` | Get Expenses | Tool to list the current user's expenses from Splitwise account. Use when you need to view expenses with optional filters like date ranges, groups, or friends. |
| `SPLITWISE_GET_FRIEND` | Get Friend Details | Tool to retrieve detailed information about a specific friend. Use when you need to get profile details and balance information for a friend by their user ID. |
| `SPLITWISE_GET_FRIENDS` | Get Friends | Tool to list current user's friends on Splitwise. Use when you need to view all friends, their balances, and shared groups. |
| `SPLITWISE_GET_GROUP` | Get Group Details | Tool to retrieve detailed information about a specific group. Returns full group details including members, balances, debts (both original and simplified), avatar URLs, and group settings. Use this when you need comprehensive information about a particular group, such as viewing who owes what to whom. Use group ID of 0 to get non-group expenses. |
| `SPLITWISE_GET_GROUPS` | Get Groups | Retrieves all groups the authenticated user belongs to, including group details, members, balances, and debt information. Returns a 'groups' array with no server-side filtering; all name- or ID-based filtering must be done client-side on the full response. Group names may share similar strings or differ in case/whitespace — normalize when matching and prefer group_id once identified. The groups array may be empty if the user belongs to no groups. |
| `SPLITWISE_GET_NOTIFICATIONS` | Get Notifications | Tool to retrieve recent activity notifications from the user's Splitwise account. Returns notifications with HTML content suitable for display, with the most recent items first. Use when you need to view recent account activity or updates. |
| `SPLITWISE_GET_USER` | Get User Information | Retrieves basic profile information about any Splitwise user by their ID. Returns the user's name, email, registration status, and profile picture. This endpoint only returns public user information. For the authenticated user's full profile (including notifications, currency preferences, and locale settings), use get_current_user instead. |
| `SPLITWISE_REMOVE_USER_FROM_GROUP` | Remove User from Group | Tool to remove a user from a group. Use when you need to remove a user from a specific group. Note: User must have a zero balance in the group for removal to succeed. 200 OK does not indicate success; always check the response 'success' field. |
| `SPLITWISE_UNDELETE_EXPENSE` | Restore Deleted Expense | Tool to restore a previously deleted expense and its associated records. Use when you need to recover an expense that was deleted. Call after confirming the correct expense ID. Not a guaranteed undo mechanism — treat deletion as high-impact and verify restoration completeness afterward. |
| `SPLITWISE_UNDELETE_GROUP` | Restore Deleted Group | Tool to restore a previously deleted group and all its associated records. Use when you need to recover a group that was deleted. Call after confirming the correct group ID. |
| `SPLITWISE_UPDATE_EXPENSE` | Update Expense | Tool to update an existing Splitwise expense. Use when you need to modify expense details such as cost, description, or participant shares. Only include fields you want to change. Note that a 200 OK response does not guarantee success - check that the errors object is empty. |
| `SPLITWISE_UPDATE_USER` | Update User | Tool to update user account details including name, email, password, and preferences. Use when you need to modify the current user's profile information. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Splitwise Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Splitwise actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Add a new expense for last night\'s group dinner splitting equally among all members.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Add a new expense for last night\'s group dinner splitting equally among all members.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Splitwise tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a new expense for $40 dinner split equally with Alice and Bob')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a new expense for $40 dinner split equally with Alice and Bob' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Splitwise Integration

- Supports both Splitwise MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Splitwise data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Splitwise access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Splitwise
- Scoped, least privilege access to Splitwise resources
- Full audit trail of agent actions to support review and compliance

## Use Splitwise with any AI Agent Framework

Choose a framework you want to connect Splitwise with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/splitwise/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/splitwise/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/splitwise/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/splitwise/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/splitwise/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/splitwise/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/splitwise/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/splitwise/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/splitwise/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/splitwise/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/splitwise/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/splitwise/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/splitwise/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/splitwise/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/splitwise/framework/autogen)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Chaser](https://composio.dev/toolkits/chaser) - Chaser is accounts receivable automation software that sends invoice reminders and helps businesses get paid faster. It streamlines the collections process to save time and improve cash flow.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone.
- [Coinranking](https://composio.dev/toolkits/coinranking) - Coinranking is a comprehensive cryptocurrency market data platform offering access to real-time coin prices, market caps, and historical data. Get accurate, up-to-date stats for thousands of digital assets in one place.
- [Coupa](https://composio.dev/toolkits/coupa) - Coupa is a business spend management platform for procurement, invoicing, and expenses. It helps organizations streamline purchasing, control costs, and gain complete visibility over financial operations.
- [CurrencyScoop](https://composio.dev/toolkits/currencyscoop) - CurrencyScoop is a developer-friendly API for real-time and historical currency exchange rates. Easily access fiat and crypto data for smart, up-to-date financial applications.
- [Daffy](https://composio.dev/toolkits/daffy) - Daffy is a modern charitable giving platform with a donor-advised fund. Easily set aside funds, grow them tax-free, and donate to over 1.7 million U.S. charities.
- [Eagle doc](https://composio.dev/toolkits/eagle_doc) - Eagle doc is an AI-powered OCR API for invoices and receipts. It delivers fast, reliable, and accurate document data extraction for seamless automation.
- [Elorus](https://composio.dev/toolkits/elorus) - Elorus is an online invoicing and time-tracking software for freelancers and small businesses. Easily manage finances, bill clients, and track work in one place.
- [Eodhd apis](https://composio.dev/toolkits/eodhd_apis) - Eodhd apis delivers comprehensive financial data, including live and historical stock prices, via robust APIs. Easily access reliable, up-to-date market insights to power your apps, dashboards, and analytics.
- [Fidel api](https://composio.dev/toolkits/fidel_api) - Fidel api is a secure platform for linking payment cards to web and mobile apps. It enables real-time card transaction monitoring and event-based automation for businesses.
- [Finage](https://composio.dev/toolkits/finage) - Finage is a secure API platform delivering real-time and historical financial data for stocks, forex, crypto, indices, and commodities. It empowers developers and businesses to access, analyze, and act on market data instantly.
- [Finmei](https://composio.dev/toolkits/finmei) - Finmei is an invoicing tool that simplifies billing, invoice management, and expense tracking. Ideal for automating and organizing your business finances in one place.
- [Fixer](https://composio.dev/toolkits/fixer) - Fixer is a currency data API offering real-time and historical exchange rates for 170 currencies. Instantly access accurate, up-to-date forex data for your applications and workflows.
- [Fixer io](https://composio.dev/toolkits/fixer_io) - Fixer.io is a lightweight API for real-time and historical foreign exchange rates. It makes global currency conversion fast, accurate, and hassle-free.

## Frequently Asked Questions

### Do I need my own developer credentials to use Splitwise with Composio?

Yes, Splitwise requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)