gatherings MCP Server

What is gatherings MCP Server?

The gatherings MCP Server is a Model Context Protocol server for managing gatherings and expense sharing. It tracks expenses and payments for social events, making it easy to calculate reimbursements and settle balances between friends. The server uses a TypeScript wrapper around a Python backend implementation.

How to use gatherings MCP Server?

Install dependencies with npm install, build the server with npm run build, and configure it in Claude Desktop using the provided JSON configuration. Set the GATHERINGS_DB_PATH and GATHERINGS_SCRIPT environment variables to point to your database file and Python script. Then invoke MCP tools like create_gathering, add_expense, and calculate_reimbursements to manage gatherings.

Key features of gatherings MCP Server

• Create, list, show, close, and delete gatherings
• Add expenses for members with amounts
• Calculate reimbursements to settle balances
• Record payments made by members
• Add and remove members from gatherings
• Rename unnamed members

Use cases of gatherings MCP Server

• Tracking shared expenses for a group trip
• Splitting costs at a dinner party among friends
• Managing payments for a club or event
• Simplifying reimbursement calculations after an outing

FAQ from gatherings MCP Server

What tools does gatherings MCP Server provide?

It provides 11 tools: create_gathering, add_expense, calculate_reimbursements, record_payment, rename_member, show_gathering, list_gatherings, close_gathering, delete_gathering, add_member, and remove_member.

What are the runtime requirements for gatherings MCP Server?

The server requires Node.js to run the TypeScript MCP server and Python to execute the backend script that handles gathering operations.

Where does gatherings MCP Server store data?

Data is stored in a SQLite database file specified by the GATHERINGS_DB_PATH environment variable.

What transport protocol does gatherings MCP Server use?

The server communicates over stdio (standard input/output) with the MCP host, as noted in the debugging section.

Is there authentication for gatherings MCP Server?

The README does not mention any authentication mechanism; tools can be configured as always allowed in the client configuration.