Can I use Splitwise as a CLI?

Yes. KosmoKrator exposes a Splitwise CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Splitwise through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Splitwise tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Splitwise credentials stored?

Splitwise credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Splitwise MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

finance

Splitwise CLI for Headless Automation

Use the Splitwise CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write Bearer token auth

Submit Splitwise feedback View package source

Splitwise CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Splitwise CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Splitwise CLI for Headless Automation
kosmokrator integrations:configure splitwise --set access_token="$SPLITWISE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call splitwise.splitwise_list_expenses '{"group_id":1,"friend_id":1,"dated_after":"example_dated_after","dated_before":"example_dated_before","limit":1,"offset":1}' --json

Discovery Before Execution

Agents and scripts can inspect Splitwise docs and schemas before choosing a function.

kosmo integrations:docs splitwise --json
kosmo integrations:docs splitwise.splitwise_list_expenses --json
kosmo integrations:schema splitwise.splitwise_list_expenses --json
kosmo integrations:search "Splitwise" --json
kosmo integrations:list --json

Useful Splitwise CLI Functions

Function	Type	Parameters	Description
`splitwise.splitwise_list_expenses`	Read	group_id, friend_id, dated_after, dated_before, limit, offset	List shared expenses from Splitwise. Optionally filter by group, friend, or date range. Returns expense details including cost, description, category, and split information.
`splitwise.splitwise_get_expense`	Read	id	Get detailed information about a specific expense in Splitwise, including cost, description, category, date, and how it was split among users.
`splitwise.splitwise_create_expense`	Write	cost, description, users, group_id, currency_code, date, category_id, details	Create a new shared expense in Splitwise. Specify the total cost, description, and users involved. The expense will be split equally unless custom owed_share amounts are provided per user.
`splitwise.splitwise_list_groups`	Read	none	List all groups the current user belongs to in Splitwise. Returns group names, member information, and balance summaries.
`splitwise.splitwise_get_group`	Read	id	Get detailed information about a specific group in Splitwise, including all members and their current balances.
`splitwise.splitwise_list_friends`	Read	none	List all friends on Splitwise with their current balance information. Shows how much you owe or are owed by each friend.
`splitwise.splitwise_get_current_user`	Read	none	Get the authenticated Splitwise user's profile, including name, email, default currency, and account settings.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Splitwise CLI Pages

CI Splitwise CLI for CI. Cron Jobs Splitwise CLI for cron jobs. Shell Scripts Splitwise CLI for shell scripts. Coding Agents Splitwise CLI for coding agents.