Gatherings (Expense Sharing)

by abutbul

293 downloads

Not rated

GitHub

About

Manages shared expenses in social events by tracking costs, calculating reimbursements, and settling balances between friends through a TypeScript wrapper around a Python backend with SQLAlchemy persistence.

Details

Author: abutbul
Repository: abutbul/gatherings-mcp
Downloads: 293
License: Apache License 2.0
Categories: Productivity, Community, Design, Workplace, Developer Tools, Infrastructure, Database, Frontend, Communication, Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Gatherings (Expense Sharing)

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/gatherings-server/build/index.js
Environment
- GATHERINGS_SCRIPT /path/to/gatherings-server/gatherings.py
- GATHERINGS_DB_PATH gatherings.db
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

From the repository

To use with Claude Desktop, add the server config:

{
  "mcpServers": {
    "gatherings": {
      "command": "node",
      "args": ["/path/to/gatherings-server/build/index.js"],
      "env": {
        "GATHERINGS_DB_PATH": "gatherings.db",
        "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py"
      },
      "disabled": false,
      "autoApprove": [],
      "alwaysAllow": [
        "create_gathering",
        "add_expense",
        "calculate_reimbursements",
        "record_payment",
        "rename_member", 
        "show_gathering",
        "list_gatherings",
        "close_gathering",
        "delete_gathering",
        "add_member",
        "remove_member"
      ],
      "timeout": 300
    }
  }
}

- command and args: Specifies how to run the server
- env: Environment variables
- GATHERINGS_DB_PATH: Path to the database file
- GATHERINGS_SCRIPT: Path to the Python script for handling gathering operations
- alwaysAllow: List of tools that will be automatically allowed without prompting
- timeout: Maximum execution time in seconds

`create_gathering`

Create a new gathering. Parameters: gathering_id (string), members (array of strings)

`add_expense`

Add an expense for a member. Parameters: gathering_id (string), member_name (string), amount (number)

`calculate_reimbursements`

Calculate reimbursements for a gathering. Parameters: gathering_id (string)

`record_payment`

Record a payment made by a member. Parameters: gathering_id (string), member_name (string), amount (number)

`rename_member`

Rename an unnamed member. Parameters: gathering_id (string), old_name (string), new_name (string)

`show_gathering`

Show details of a gathering. Parameters: gathering_id (string)

`list_gatherings`

List all gatherings.

`close_gathering`

Close a gathering. Parameters: gathering_id (string)

`delete_gathering`

Delete a gathering. Parameters: gathering_id (string), force (optional boolean)

`add_member`

Add a new member to a gathering. Parameters: gathering_id (string), member_name (string)

`remove_member`

Remove a member from a gathering. Parameters: gathering_id (string), member_name (string)

- create_gathering - Create a new gathering
- Takes gathering_id and members as required parameters
- add_expense - Add an expense for a member
- Takes gathering_id, member_name, and amount as required parameters
- calculate_reimbursements - Calculate reimbursements for a gathering
- Takes gathering_id as a required parameter
- record_payment - Record a payment made by a member
- Takes gathering_id, member_name, and amount as required parameters
- rename_member - Rename an unnamed member
- Takes gathering_id, old_name, and new_name as required parameters
- show_gathering - Show details of a gathering
- Takes gathering_id as a required parameter
- list_gatherings - List all gatherings
- close_gathering - Close a gathering
- Takes gathering_id as a required parameter
- delete_gathering - Delete a gathering
- Takes gathering_id as a required parameter, optional force parameter
- add_member - Add a new member to a gathering
- Takes gathering_id and member_name as required parameters
- remove_member - Remove a member from a gathering
- Takes gathering_id and member_name as required parameters

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gatherings (expense sharing)": {
            "env": {
                "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
                "GATHERINGS_DB_PATH": "gatherings.db"
            },
            "args": [
                "/path/to/gatherings-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
        "GATHERINGS_DB_PATH": "gatherings.db"
    },
    "args": [
        "/path/to/gatherings-server/build/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
        "GATHERINGS_DB_PATH": "gatherings.db"
    },
    "args": [
        "/path/to/gatherings-server/build/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py",
        "GATHERINGS_DB_PATH": "gatherings.db"
    },
    "args": [
        "/path/to/gatherings-server/build/index.js"
    ],
    "command": "node"
}

gatherings MCP Server

A Model Context Protocol server for managing gatherings and expense sharing.

This is a TypeScript-based MCP server that helps track expenses and payments for social events, making it easy to calculate reimbursements and settle balances between friends.

Architecture Note

Important: This project uses a non-standard architecture for a Node.js application. The TypeScript MCP server acts as a wrapper around a Python backend implementation. The Node.js server receives MCP requests, translates them to command-line calls to the Python script, and returns the results.

While this architecture works for our current needs, it's not the most efficient or maintainable approach for a production application.

TODO

- Refactor the implementation to use a more standard architecture: - Either fully migrate the backend to TypeScript/JavaScript - Or implement proper inter-process communication between Node.js and Python components - Or replace with a REST API approach where the Python backend provides an API that the MCP server consumes - Improve error handling between the Node.js and Python components - Add automated tests for the integration between components - Optimise Dockerfile

Features

Tools

- create_gathering - Create a new gathering - Takes gathering_id and members as required parameters - add_expense - Add an expense for a member - Takes gathering_id, member_name, and amount as required parameters - calculate_reimbursements - Calculate reimbursements for a gathering - Takes gathering_id as a required parameter - record_payment - Record a payment made by a member - Takes gathering_id, member_name, and amount as required parameters - rename_member - Rename an unnamed member - Takes gathering_id, old_name, and new_name as required parameters - show_gathering - Show details of a gathering - Takes gathering_id as a required parameter - list_gatherings - List all gatherings - close_gathering - Close a gathering - Takes gathering_id as a required parameter - delete_gathering - Delete a gathering - Takes gathering_id as a required parameter, optional force parameter - add_member - Add a new member to a gathering - Takes gathering_id and member_name as required parameters - remove_member - Remove a member from a gathering - Takes gathering_id and member_name as required parameters

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

Configuration

To use with Claude Desktop, add the server config:

{
  "mcpServers": {
    "gatherings": {
      "command": "node",
      "args": ["/path/to/gatherings-server/build/index.js"],
      "env": {
        "GATHERINGS_DB_PATH": "gatherings.db",
        "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py"
      },
      "disabled": false,
      "autoApprove": [],
      "alwaysAllow": [
        "create_gathering",
        "add_expense",
        "calculate_reimbursements",
        "record_payment",
        "rename_member", 
        "show_gathering",
        "list_gatherings",
        "close_gathering",
        "delete_gathering",
        "add_member",
        "remove_member"
      ],
      "timeout": 300
    }
  }
}

Configuration Options

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

create_gathering

add_expense

calculate_reimbursements

record_payment

rename_member

show_gathering

list_gatherings

close_gathering

delete_gathering

add_member

remove_member

Claude Desktop / Cursor

Linux

Macos

Windows

gatherings MCP Server

Architecture Note

TODO

Features

Tools

Development

Installation

Configuration

Configuration Options

Debugging

Install

More like this

Time

Github SSE

Npx Y convex@latest mcp start

Inbox Zero

BlenderMCP

IDA Pro MCP

`create_gathering`

`add_expense`

`calculate_reimbursements`

`record_payment`

`rename_member`

`show_gathering`

`list_gatherings`

`close_gathering`

`delete_gathering`

`add_member`

`remove_member`