gatherings MCP Server logo

gatherings MCP Server

by abutbul

A Model Context Protocol (MCP) server for managing gatherings and expense sharing. It helps track expenses and payments for social events, making it easy to calculate reimbursements and settle balances between friends.

View on GitHub

Last updated: N/A

What is gatherings MCP Server?

The gatherings MCP Server is a TypeScript-based server that acts as a wrapper around a Python backend to manage gatherings and track expenses. It facilitates the calculation of reimbursements and settlement of balances between members of a gathering.

How to use gatherings MCP Server?

To use the server, configure it with Claude Desktop by adding the provided server configuration. This involves specifying the command to run the server, environment variables for the database and Python script paths, allowed tools, and timeout settings. The provided tools can then be used to manage gatherings and expenses.

Key features of gatherings MCP Server

  • Create and manage gatherings

  • Add and track expenses for members

  • Calculate reimbursements between members

  • Record payments made by members

  • Rename members within a gathering

  • List and show details of gatherings

  • Close and delete gatherings

  • Add and remove members from gatherings

Use cases of gatherings MCP Server

  • Tracking expenses for group trips

  • Managing shared costs for parties and events

  • Calculating reimbursements for shared meals

  • Settling balances between roommates

  • Organizing and tracking expenses for group projects

FAQ from gatherings MCP Server

What is MCP?

MCP stands for Model Context Protocol, a protocol for communication between applications.

What database does this use?

The database path is configurable via the GATHERINGS_DB_PATH environment variable.

Why is there a Python backend?

The project uses a non-standard architecture with a TypeScript MCP server wrapping a Python backend for handling gathering operations.

How do I debug the server?

Use the MCP Inspector, accessible via npm run inspector, to debug the server.

What are the 'alwaysAllow' tools?

These are tools that will be automatically allowed without prompting the user for permission.