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
andmembers
as required parameters
- Takes
add_expense
- Add an expense for a member- Takes
gathering_id
,member_name
, andamount
as required parameters
- Takes
calculate_reimbursements
- Calculate reimbursements for a gathering- Takes
gathering_id
as a required parameter
- Takes
record_payment
- Record a payment made by a member- Takes
gathering_id
,member_name
, andamount
as required parameters
- Takes
rename_member
- Rename an unnamed member- Takes
gathering_id
,old_name
, andnew_name
as required parameters
- Takes
show_gathering
- Show details of a gathering- Takes
gathering_id
as a required parameter
- Takes
list_gatherings
- List all gatheringsclose_gathering
- Close a gathering- Takes
gathering_id
as a required parameter
- Takes
delete_gathering
- Delete a gathering- Takes
gathering_id
as a required parameter, optionalforce
parameter
- Takes
add_member
- Add a new member to a gathering- Takes
gathering_id
andmember_name
as required parameters
- Takes
remove_member
- Remove a member from a gathering- Takes
gathering_id
andmember_name
as required parameters
- Takes
Development
Install dependencies:
Build the server:
For development with auto-rebuild:
Installation
Configuration
To use with Claude Desktop, add the server config:
Configuration Options
command
andargs
: Specifies how to run the serverenv
: Environment variablesGATHERINGS_DB_PATH
: Path to the database fileGATHERINGS_SCRIPT
: Path to the Python script for handling gathering operations
alwaysAllow
: List of tools that will be automatically allowed without promptingtimeout
: Maximum execution time in seconds
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
The Inspector will provide a URL to access debugging tools in your browser.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Model Context Protocol server that helps track expenses and calculate reimbursements for social events, making it easy to settle balances between friends.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn extensible Model Context Protocol server that provides standardized access to social platform data (currently Farcaster) and onchain data for LLMs.Last updated -510TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.Last updated -191672TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides comprehensive integration with PayPal's APIs, enabling seamless interaction with payment processing, invoicing, subscription management, and business operations through a standardized interface.Last updated -TypeScriptApache 2.0
Paddle MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for interacting with the Paddle Billing API, enabling users to manage products, prices, customers, transactions, subscriptions, and create custom financial reports.Last updated -87310TypeScriptApache 2.0