splitwise-mcp 2.0.0 → 2.0.2

package/dist/tools/groups.js

@@ -1,142 +1,88 @@
-export const toolDefinitions = [
-    {
-        name: 'sw_list_groups',
+import { z } from 'zod';
+export function registerGroupTools(server, client) {
+    server.registerTool('sw_list_groups', {
         description: 'List all Splitwise groups the current user belongs to. Returns id, name, and members for each group. Use this to resolve a group name to its id.',
         annotations: { readOnlyHint: true },
-        inputSchema: { type: 'object', properties: {}, required: [] },
-    },
-    {
-        name: 'sw_get_group',
+    }, async () => {
+        const data = await client.request('GET', '/get_groups');
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_get_group', {
         description: 'Get details of a single Splitwise group including all members and balances.',
         annotations: { readOnlyHint: true },
         inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'integer', description: 'Group ID' },
-            },
-            required: ['id'],
+            id: z.number().describe('Group ID'),
         },
-    },
-    {
-        name: 'sw_create_group',
+    }, async ({ id }) => {
+        const data = await client.request('GET', `/get_group/${id}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_create_group', {
         description: 'Create a new Splitwise group.',
         inputSchema: {
-            type: 'object',
-            properties: {
-                name: { type: 'string', description: 'Group name' },
-                group_type: {
-                    type: 'string',
-                    enum: ['apartment', 'house', 'trip', 'other'],
-                    description: 'Type of group',
-                },
-                simplify_by_default: { type: 'boolean', description: 'Whether to simplify debts by default' },
-            },
-            required: ['name'],
+            name: z.string().describe('Group name'),
+            group_type: z.enum(['apartment', 'house', 'trip', 'other']).describe('Type of group').optional(),
+            simplify_by_default: z.boolean().describe('Whether to simplify debts by default').optional(),
         },
-    },
-    {
-        name: 'sw_add_user_to_group',
-        description: 'Add a user to a Splitwise group. Provide user_id (preferred, use sw_list_friends to resolve a name) or first_name + last_name + email to invite by email.',
+    }, async ({ name, group_type, simplify_by_default }) => {
+        const body = { name };
+        if (group_type !== undefined)
+            body.group_type = group_type;
+        if (simplify_by_default !== undefined)
+            body.simplify_by_default = simplify_by_default;
+        const data = await client.request('POST', '/create_group', body);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_add_user_to_group', {
+        description: "Add a user to a Splitwise group. Provide user_id (preferred, use sw_list_friends to resolve a name) or first_name + last_name + email to invite by email.",
         inputSchema: {
-            type: 'object',
-            properties: {
-                group_id: { type: 'integer', description: 'Group ID' },
-                user_id: { type: 'integer', description: 'User ID (preferred)' },
-                first_name: { type: 'string' },
-                last_name: { type: 'string' },
-                email: { type: 'string' },
-            },
-            required: ['group_id'],
+            group_id: z.number().describe('Group ID'),
+            user_id: z.number().describe('User ID (preferred)').optional(),
+            first_name: z.string().optional(),
+            last_name: z.string().optional(),
+            email: z.string().optional(),
         },
-    },
-    {
-        name: 'sw_remove_user_from_group',
+    }, async ({ group_id, user_id, first_name, last_name, email }) => {
+        let body;
+        if (user_id !== undefined) {
+            body = { group_id, user_id };
+        }
+        else {
+            if (!first_name || !last_name || !email) {
+                throw new Error('first_name, last_name, and email are required when user_id is not provided');
+            }
+            body = { group_id, first_name, last_name, email };
+        }
+        const data = await client.request('POST', '/add_user_to_group', body);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_remove_user_from_group', {
         description: 'Remove a user from a Splitwise group.',
         inputSchema: {
-            type: 'object',
-            properties: {
-                group_id: { type: 'integer', description: 'Group ID' },
-                user_id: { type: 'integer', description: 'User ID to remove' },
-            },
-            required: ['group_id', 'user_id'],
+            group_id: z.number().describe('Group ID'),
+            user_id: z.number().describe('User ID to remove'),
         },
-    },
-    {
-        name: 'sw_delete_group',
+    }, async ({ group_id, user_id }) => {
+        const data = await client.request('POST', '/remove_user_from_group', { group_id, user_id });
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_delete_group', {
         description: 'Soft-delete a Splitwise group.',
         annotations: { destructiveHint: true },
         inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'integer', description: 'Group ID to delete' },
-            },
-            required: ['id'],
+            id: z.number().describe('Group ID to delete'),
         },
-    },
-    {
-        name: 'sw_undelete_group',
+    }, async ({ id }) => {
+        const data = await client.request('POST', `/delete_group/${id}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_undelete_group', {
         description: 'Restore a soft-deleted Splitwise group.',
         inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'integer', description: 'Group ID to restore' },
-            },
-            required: ['id'],
+            id: z.number().describe('Group ID to restore'),
         },
-    },
-];
-export async function handleTool(name, args, client) {
-    switch (name) {
-        case 'sw_list_groups': {
-            const data = await client.request('GET', '/get_groups');
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_get_group': {
-            const { id } = args;
-            const data = await client.request('GET', `/get_group/${id}`);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_create_group': {
-            const { name, group_type, simplify_by_default } = args;
-            const body = { name };
-            if (group_type !== undefined)
-                body.group_type = group_type;
-            if (simplify_by_default !== undefined)
-                body.simplify_by_default = simplify_by_default;
-            const data = await client.request('POST', '/create_group', body);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_add_user_to_group': {
-            const { group_id, user_id, first_name, last_name, email } = args;
-            let body;
-            if (user_id !== undefined) {
-                body = { group_id, user_id };
-            }
-            else {
-                if (!first_name || !last_name || !email) {
-                    throw new Error('first_name, last_name, and email are required when user_id is not provided');
-                }
-                body = { group_id, first_name, last_name, email };
-            }
-            const data = await client.request('POST', '/add_user_to_group', body);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_remove_user_from_group': {
-            const { group_id, user_id } = args;
-            const data = await client.request('POST', '/remove_user_from_group', { group_id, user_id });
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_delete_group': {
-            const { id } = args;
-            const data = await client.request('POST', `/delete_group/${id}`);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_undelete_group': {
-            const { id } = args;
-            const data = await client.request('POST', `/undelete_group/${id}`);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
+    }, async ({ id }) => {
+        const data = await client.request('POST', `/undelete_group/${id}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
 }

package/dist/tools/user.js

@@ -1,70 +1,48 @@
-export const toolDefinitions = [
-    {
-        name: 'sw_get_current_user',
-        description: 'Get the authenticated Splitwise user\'s profile (id, first_name, last_name, email). Use the returned id when building custom expense splits.',
+import { z } from 'zod';
+export function registerUserTools(server, client) {
+    server.registerTool('sw_get_current_user', {
+        description: "Get the authenticated Splitwise user's profile (id, first_name, last_name, email). Use the returned id when building custom expense splits.",
         annotations: { readOnlyHint: true },
-        inputSchema: { type: 'object', properties: {}, required: [] },
-    },
-    {
-        name: 'sw_get_user',
-        description: 'Get another Splitwise user\'s profile by id.',
+    }, async () => {
+        const data = await client.request('GET', '/get_current_user');
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_get_user', {
+        description: "Get another Splitwise user's profile by id.",
         annotations: { readOnlyHint: true },
         inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'integer', description: 'User ID' },
-            },
-            required: ['id'],
+            id: z.number().describe('User ID'),
         },
-    },
-    {
-        name: 'sw_update_user',
-        description: 'Update the current user\'s profile fields. id must be the current user\'s id.',
+    }, async ({ id }) => {
+        const data = await client.request('GET', `/get_user/${id}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_update_user', {
+        description: "Update the current user's profile fields. id must be the current user's id.",
         inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'integer', description: 'User ID (must be the current user\'s id)' },
-                first_name: { type: 'string' },
-                last_name: { type: 'string' },
-                email: { type: 'string' },
-                password: { type: 'string' },
-                locale: { type: 'string' },
-                default_currency: { type: 'string' },
-            },
-            required: ['id'],
+            id: z.number().describe("User ID (must be the current user's id)"),
+            first_name: z.string().optional(),
+            last_name: z.string().optional(),
+            email: z.string().optional(),
+            password: z.string().optional(),
+            locale: z.string().optional(),
+            default_currency: z.string().optional(),
         },
-    },
-];
-export async function handleTool(name, args, client) {
-    switch (name) {
-        case 'sw_get_current_user': {
-            const data = await client.request('GET', '/get_current_user');
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_get_user': {
-            const { id } = args;
-            const data = await client.request('GET', `/get_user/${id}`);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_update_user': {
-            const { id, first_name, last_name, email, password, locale, default_currency } = args;
-            const body = {};
-            if (first_name !== undefined)
-                body.first_name = first_name;
-            if (last_name !== undefined)
-                body.last_name = last_name;
-            if (email !== undefined)
-                body.email = email;
-            if (password !== undefined)
-                body.password = password;
-            if (locale !== undefined)
-                body.locale = locale;
-            if (default_currency !== undefined)
-                body.default_currency = default_currency;
-            const data = await client.request('POST', `/update_user/${id}`, body);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
+    }, async ({ id, first_name, last_name, email, password, locale, default_currency }) => {
+        const body = {};
+        if (first_name !== undefined)
+            body.first_name = first_name;
+        if (last_name !== undefined)
+            body.last_name = last_name;
+        if (email !== undefined)
+            body.email = email;
+        if (password !== undefined)
+            body.password = password;
+        if (locale !== undefined)
+            body.locale = locale;
+        if (default_currency !== undefined)
+            body.default_currency = default_currency;
+        const data = await client.request('POST', `/update_user/${id}`, body);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
 }

package/dist/tools/utilities.js

@@ -1,89 +1,54 @@
-export const toolDefinitions = [
-    {
-        name: 'sw_get_notifications',
+import { z } from 'zod';
+export function registerUtilityTools(server, client) {
+    server.registerTool('sw_get_notifications', {
         description: 'Get recent Splitwise activity notifications for the current user.',
         annotations: { readOnlyHint: true },
-        inputSchema: { type: 'object', properties: {}, required: [] },
-    },
-    {
-        name: 'sw_get_categories',
+    }, async () => {
+        const data = await client.request('GET', '/get_notifications');
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_get_categories', {
         description: 'Get the hierarchical list of Splitwise expense categories. Use the returned id as category_id when creating expenses.',
         annotations: { readOnlyHint: true },
-        inputSchema: { type: 'object', properties: {}, required: [] },
-    },
-    {
-        name: 'sw_get_currencies',
+    }, async () => {
+        const data = await client.request('GET', '/get_categories');
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_get_currencies', {
         description: 'Get all Splitwise-supported currency codes and units. Use the currency_code value when creating expenses in non-default currencies.',
         annotations: { readOnlyHint: true },
-        inputSchema: { type: 'object', properties: {}, required: [] },
-    },
-    {
-        name: 'sw_get_comments',
+    }, async () => {
+        const data = await client.request('GET', '/get_currencies');
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_get_comments', {
         description: 'Get all comments on a Splitwise expense.',
         annotations: { readOnlyHint: true },
         inputSchema: {
-            type: 'object',
-            properties: {
-                expense_id: { type: 'integer', description: 'Expense ID to get comments for' },
-            },
-            required: ['expense_id'],
+            expense_id: z.number().describe('Expense ID to get comments for'),
         },
-    },
-    {
-        name: 'sw_create_comment',
+    }, async ({ expense_id }) => {
+        const data = await client.request('GET', `/get_comments?expense_id=${expense_id}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_create_comment', {
         description: 'Add a comment to a Splitwise expense.',
         inputSchema: {
-            type: 'object',
-            properties: {
-                expense_id: { type: 'integer', description: 'Expense ID to comment on' },
-                content: { type: 'string', description: 'Comment text' },
-            },
-            required: ['expense_id', 'content'],
+            expense_id: z.number().describe('Expense ID to comment on'),
+            content: z.string().describe('Comment text'),
         },
-    },
-    {
-        name: 'sw_delete_comment',
+    }, async ({ expense_id, content }) => {
+        const data = await client.request('POST', '/create_comment', { expense_id, content });
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('sw_delete_comment', {
         description: 'Delete a comment by id.',
         annotations: { destructiveHint: true },
         inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'integer', description: 'Comment ID to delete' },
-            },
-            required: ['id'],
+            id: z.number().describe('Comment ID to delete'),
         },
-    },
-];
-export async function handleTool(name, args, client) {
-    switch (name) {
-        case 'sw_get_notifications': {
-            const data = await client.request('GET', '/get_notifications');
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_get_categories': {
-            const data = await client.request('GET', '/get_categories');
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_get_currencies': {
-            const data = await client.request('GET', '/get_currencies');
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_get_comments': {
-            const { expense_id } = args;
-            const data = await client.request('GET', `/get_comments?expense_id=${expense_id}`);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_create_comment': {
-            const { expense_id, content } = args;
-            const data = await client.request('POST', '/create_comment', { expense_id, content });
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        case 'sw_delete_comment': {
-            const { id } = args;
-            const data = await client.request('POST', `/delete_comment/${id}`);
-            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-        }
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
+    }, async ({ id }) => {
+        const data = await client.request('POST', `/delete_comment/${id}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
 }

package/package.json

@@ -1,12 +1,28 @@
 {
   "name": "splitwise-mcp",
-  "version": "2.0.0",
-  "description": "Splitwise MCP server for Claude — developed and maintained by AI (Claude Sonnet 4.6)",
-  "author": "Claude Sonnet 4.6 (AI) <https://www.anthropic.com/claude>",
+  "version": "2.0.2",
+  "mcpName": "io.github.chrischall/splitwise-mcp",
+  "description": "Splitwise MCP server for Claude — developed and maintained by AI (Claude Code)",
+  "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/chrischall/splitwise-mcp.git"
   },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "splitwise",
+    "expenses",
+    "expense-tracking",
+    "groups",
+    "friends",
+    "split-bills",
+    "finance",
+    "shared-expenses"
+  ],
   "type": "module",
   "bin": {
     "splitwise-mcp": "dist/index.js"
@@ -15,7 +31,8 @@
     "dist",
     ".claude-plugin",
     "SKILL.md",
-    ".mcp.json"
+    ".mcp.json",
+    "server.json"
   ],
   "scripts": {
     "build": "tsc && npm run bundle",
@@ -27,12 +44,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "dotenv": "^17.4.0"
+    "dotenv": "^17.4.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
     "@vitest/coverage-v8": "^4.1.2",
-    "esbuild": "^0.27.0",
+    "esbuild": "^0.28.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"
   }

package/server.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.chrischall/splitwise-mcp",
+  "description": "Splitwise expense and group management for Claude — shared expenses, settle up, friends",
+  "repository": {
+    "url": "https://github.com/chrischall/splitwise-mcp",
+    "source": "github"
+  },
+  "version": "2.0.2",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "splitwise-mcp",
+      "version": "2.0.2",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "SPLITWISE_API_KEY",
+          "description": "Your Splitwise API key (splitwise.com/apps/api)",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}