Gatherings MCP Server

What is Gatherings MCP Server?

A Model Context Protocol server that provides an API for AI assistants to interact with the Gatherings application, enabling management of shared expenses for social events where costs are split among participants. It uses SQLAlchemy for data persistence and the MCP Python SDK.

How to use Gatherings MCP Server?

Install dependencies with uv pip install -r requirements.txt or pip install -r requirements.txt, optionally set environment variables GATHERINGS_DB_PATH and GATHERINGS_SCRIPT, then run python gatherings_mcp_server.py. The server communicates over stdio with any MCP client. Tools are invoked by name with parameters (e.g., create_gathering, add_expense, calculate_reimbursements).

Key features of Gatherings MCP Server

• Create and manage gatherings with multiple members
• Add expenses for specific members
• Calculate fair reimbursements
• Record payments and reimbursements
• Generate detailed payment summaries
• Add, remove, and rename members

Use cases of Gatherings MCP Server

• Splitting dinner costs among a group of friends
• Managing shared expenses for a group outing
• Tracking who paid and who owes for a social event

FAQ from Gatherings MCP Server

What dependencies does Gatherings MCP Server require?

Python 3.8+, SQLAlchemy, MCP SDK, and the uv package manager (optional but recommended). Dependencies are listed in requirements.txt.

How does the server persist data?

It uses SQLAlchemy ORM with a database file whose path can be customized via the GATHERINGS_DB_PATH environment variable.

What transport does the server use?

The server communicates over stdio, making it compatible with MCP protocol clients that expect a subprocess.

What tools are available and how do I call them?

Tools include create_gathering, add_expense, calculate_reimbursements, record_payment, rename_member, show_gathering, list_gatherings, close_gathering, delete_gathering, add_member, and remove_member. Each tool expects specific parameters as documented in the API reference.

Are there any known limits or restrictions?

A member can only be removed if they have no expenses. The delete_gathering command requires force=True for closed gatherings.