Back to Generator

Splitwise MCP Server Setup Guide

Welcome to the Splitwise MCP Server! This guide will help you set up MCP (Model Context Protocol) servers for Splitwise integration across different AI clients.

What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI assistants to connect with external tools and data sources. By setting up a Splitwise MCP server, you'll be able to:

Prerequisites

Before you begin, make sure you have:

  1. Splitwise Account: Sign up at Splitwise.com if you don't have one
  2. AI Client: One of the supported AI clients installed:
  3. VS Code with GitHub Copilot
  4. Cursor AI
  5. Claude Desktop

Quick Setup

Step 1: Generate Your Configuration

  1. Visit our Splitwise MCP Configuration Generator
  2. Click "✨ Generate Magic Configs"
  3. Authorize the application with your Splitwise account
  4. Copy the configuration for your preferred AI client

Step 2: Install Configuration

Choose your AI client and follow the specific instructions:

VS Code Copilot Setup

Prerequisites

Installation Steps

  1. Create MCP Configuration File:
  2. Open VS Code
  3. Create a .vscode/mcp.json file in your workspace, or

  4. Use Command Palette: MCP: Add Server → Select Workspace Settings

  5. Add Splitwise Configuration: json { "servers": { "splitwise": { "url": "https://mcp-gateway.freengers.com/remote/gateway/splitwise/mcp", "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } } } }

  6. Replace Token: Replace YOUR_ACCESS_TOKEN with the token from our generator

  7. Restart VS Code: Close and reopen VS Code to load the MCP server

  8. Test Integration:

  9. Open Chat view (⌃⌘I)
  10. Select Agent mode
  11. Try: "Show me my Splitwise groups" or "Create a new expense"

Useful Commands

Cursor AI Setup

Prerequisites

Installation Steps

  1. Open MCP Configuration:
  2. Go to Settings → Cursor Settings

  3. Enable MCP servers option

  4. Add Configuration File: Create one of these files:

  5. Project-specific: .cursor/mcp.json in your project

  6. Global: ~/.cursor/mcp.json in your home directory

  7. Add Splitwise Configuration: json { "mcpServers": { "splitwise": { "url": "https://mcp-gateway.freengers.com/remote/gateway/splitwise/mcp", "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } } } }

  8. Replace Token: Replace YOUR_ACCESS_TOKEN with the token from our generator

  9. Restart Cursor: Restart the application to load the MCP server

  10. Test Integration:

  11. Open Chat/Composer
  12. Enable MCP tools in the tools list
  13. Try: "Help me split a restaurant bill" or "Show my recent expenses"

Claude Desktop Setup

Prerequisites

Installation Steps

  1. Locate Configuration File:
  2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  3. Windows: %APPDATA%\Claude\claude_desktop_config.json

  4. Edit Configuration:

  5. Open Claude Desktop
  6. Go to Settings → Developer → Edit Config

  7. Or manually edit the file with a text editor

  8. Add Splitwise Configuration: json { "mcpServers": { "splitwise": { "url": "https://mcp-gateway.freengers.com/remote/gateway/splitwise/mcp", "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } } } }

  9. Replace Token: Replace YOUR_ACCESS_TOKEN with the token from our generator

  10. Restart Claude Desktop: Close and reopen the application

  11. Test Integration:

  12. Start a new conversation
  13. Try: "List my Splitwise expenses" or "Create a grocery expense for $50"

Common Use Cases

Once set up, you can use natural language to:

Expense Management

Group Management

Reporting

Troubleshooting

Common Issues

MCP Server Not Loading: - Verify the configuration file syntax is valid JSON - Check that the access token is correct - Restart your AI client

Authorization Errors: - Regenerate your access token using our generator - Ensure the token hasn't expired - Check that you have the necessary Splitwise permissions

Tool Not Available: - Confirm MCP support is enabled in your AI client - Check that the Splitwise tools appear in the available tools list - Try explicitly mentioning "Splitwise" in your prompt

Getting Help

If you encounter issues:

  1. Check Server Status: Visit our status page to ensure the MCP gateway is operational
  2. Review Logs: Check your AI client's output/console for error messages
  3. Regenerate Token: Try generating a fresh configuration with a new token
  4. Contact Support: Email us at divyanshubansal.db@gmail.com

Advanced Configuration

Environment Variables

For development or custom deployments, you can use environment variables:

export SPLITWISE_TOKEN="your_token_here"
export MCP_GATEWAY_URL="https://mcp-gateway.freengers.com/remote/gateway/splitwise/mcp"

Custom MCP Gateway

If you're running your own MCP gateway, update the URL in the configuration:

{
  "url": "https://your-custom-gateway.com/mcp/splitwise"
}

Security Notes

Updates and Maintenance

Resources

Official Documentation

Community

Need more help? Contact us at divyanshubansal.db@gmail.com or visit our GitHub repository for the latest updates.