Gatherings MCP Server

Source

The Gatherings MCP Server provides an API that allows AI assistants to interact with the Gatherings application through the Machine Conversation Protocol. This enables AI systems to help users manage shared expenses for social events, outings, or any gathering where costs are split among participants.

Catalog onlyCatalog onlySTDIO

Overview

The Gatherings MCP Server is an API that allows AI assistants to interact with the Gatherings application through the Machine Conversation Protocol, enabling users to manage shared expenses for social events and gatherings.

To use the Gatherings MCP Server, clone the repository, install the required dependencies, set up environment variables if needed, and start the server using Python. The server will then be ready to handle requests from MCP protocol clients.

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 members from gatherings - Rename members as needed

Managing expenses for group dinners or outings.
Facilitating cost-sharing for events like parties or trips.
Keeping track of payments and reimbursements among friends or family.

Add to your AI client

Use these steps to connect Gatherings MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "gatherings-mcp-python-abutbul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gatherings-mcp-python-abutbul"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "gatherings-mcp-python-abutbul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gatherings-mcp-python-abutbul"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "gatherings-mcp-python-abutbul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gatherings-mcp-python-abutbul"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "gatherings-mcp-python-abutbul": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gatherings-mcp-python-abutbul"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gatherings-mcp-python-abutbul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gatherings-mcp-python-abutbul"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "gatherings-mcp-python-abutbul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gatherings-mcp-python-abutbul"
      ]
    }
  }
}

FAQ

Can I use this server for any type of gathering?

Yes! It is designed for any social event where costs need to be split among participants.

What programming language is used?

The server is built using Python.

Is there a limit to the number of members in a gathering?

No, you can create gatherings with as many members as needed.

Research and data