Splid MCP

A Model Context Protocol (MCP) server that exposes Splid (splid.app) via tools, powered by the reverse‑engineeredsplid-jsclient.

- Language/Runtime: Node.js (ESM) + TypeScript
- Transport: Streamable HTTP (and stdio for local inspector)
- License: MIT

Then connect tohttp://localhost:8000/mcpusing "Streamable HTTP".

All tools support an optional group selector to override the default fromCODE:

- groupId?: string
- groupCode?: string(invite code)
- groupName?: string(reserved; not yet supported)

If none provided, the server uses the default group fromCODE.

- Purpose: connectivity check
- Output:{ ok: true }

- Purpose: show the currently selected group and its members
- Input: none
- Output: JSON containing group info and members

- Purpose: create a new expense entry
- Input:

- title: string
- amount: number > 0
- currencyCode?: string(defaults to the group default when omitted)
- payers: { userId?: string; name?: string; amount: number > 0 }[](at least 1)
- profiteers: { userId?: string; name?: string; share: number in (0,1] }[](at least 1)
- Optional group selector fields

- Names are case‑insensitive and resolved to member GlobalId; unknown names return a clear error.
- The sum of allsharevalues must equal 1 (±1e‑6).

{ "title": "Dinner", "amount": 12.5, "payers": [{ "name": "Alice", "amount": 12.5 }], "profiteers": [{ "name": "Bob", "share": 0.6 }, { "name": "Alice", "share": 0.4 }] }

{ "title": "Dinner", "amount": 12.5, "payers": [{ "userId": "<GlobalId>", "amount": 12.5 }], "profiteers": [{ "userId": "<GlobalId>", "share": 1 }] }

- Purpose: list recent entries in a group
- Input:

- limit?: number(1..100, default 20)
- Optional group selector fields

- Purpose: show balances/summary for a group
- Input:

- Optional group selector fields

- URL:http://localhost:8000/mcp
- No auth headers required; use MCP Inspector to test.

- "Bad Request: Server not initialized": refresh and reconnect; first POST must beinitialize.
- 400 with share errors: ensure shares are in (0,1] and sum to 1.
- Unknown name: check exact member names inwhoamioutput.

- Env variables:

- CODE: Splid invite/join code for the default group
- PORT(optional): default 8000

- Splid JS client:https://github.com/LinusBolls/splid-js
- MCP Server template / docs:https://github.com/InteractionCo/mcp-server-template

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar