Splitwise MCP for AI Agents

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.

Splitwise logoSplitwise
Oauth2Api Key

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.

27 Tools

Try Splitwise now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Splitwise
Try asking
TOOLS

Supported Tools

Every Splitwise action and event your agent gets out of the box.

Add Friend

Tool to add a new friend to Splitwise.

Add User to Group

Tool to add a user to a group.

Create Comment

Tool to create a comment on a specific expense.

Create Expense

Tool to create a new Splitwise expense.

Create Friends

Tool to add multiple friends at once to Splitwise.

Create Group

Tool to create a new group in Splitwise.

Delete Comment

Tool to delete a comment by its ID.

Delete Expense

Tool to delete an existing expense by its ID.

Delete Friend

Tool to delete an existing friend by ID.

Delete Group

Tool to delete a group and all associated records by its ID.

Get Categories

Tool to retrieve expense categories.

Get Comments

Tool to retrieve all comments associated with a specific expense.

Get Currencies

Tool to retrieve a list of supported currencies.

Get Current User

Tool to retrieve information about the current authenticated user.

Get Expense

Tool to retrieve detailed information about a specific expense by ID.

Get Expenses

Tool to list the current user's expenses from Splitwise account.

Get Friend Details

Tool to retrieve detailed information about a specific friend.

Get Friends

Tool to list current user's friends on Splitwise.

Get Group Details

Tool to retrieve detailed information about a specific group.

Get Groups

Retrieves all groups the authenticated user belongs to, including group details, members, balances, and debt information.

Get Notifications

Tool to retrieve recent activity notifications from the user's Splitwise account.

Get User Information

Retrieves basic profile information about any Splitwise user by their ID.

Remove User from Group

Tool to remove a user from a group.

Restore Deleted Expense

Tool to restore a previously deleted expense and its associated records.

Restore Deleted Group

Tool to restore a previously deleted group and all its associated records.

Update Expense

Tool to update an existing Splitwise expense.

Update User

Tool to update user account details including name, email, password, and preferences.

SETUP GUIDE

Connect Splitwise MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

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}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

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}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Splitwise API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

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');
Import and initialize Composio client, then create a Tool Router session
3

Execute Splitwise Tools via Tool Router with Your Agent

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);
Get tools from Tool Router session and execute Splitwise actions with your Agent

Why Use Composio?

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

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

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

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
FAQ

Frequently asked questions

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

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

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

Start with Splitwise.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Splitwise tool your agent needs.Free to start.

Start building