Skip to Content
Settlr

Connect an AI app

Use Settlr from Claude, ChatGPT and other apps that support the Model Context Protocol.

Settlr has an MCP server, so AI apps that support custom connectors can add, find, change and delete your expenses, and create groups and friends, as you. The app's own model does the talking, so this works even where the built-in assistant isn't set up.

Connect

Copy the connector URL

Open Settings → AI assistants and copy the Connector URL: your Settlr site followed by /api/mcp.

Settings, with the connector URL under AI assistants

Add it to your AI app

  • Claude: Settings → Connectors → Add custom connector.
  • ChatGPT: turn on developer mode under Settings → Apps → Advanced settings, then create an app with the URL.

No client ID or secret is needed: the app registers itself.

Sign in and approve

The app sends you to Settlr. Sign in if you aren't already, check the app's name and where it'll send you back, and choose Allow. Settlr asks every time an app connects.

Tools

ToolWhat it does
list_friends_and_groupsYour name, friends, groups (with members and currency), default currency and today's date
add_personal_expenseAdds an expense that's just yours
add_friend_expenseAdds a one-on-one expense with a friend
add_group_expenseAdds an expense in a group, in the group's currency
create_groupCreates a group; members are just names
add_friendAdds a friend for one-on-one expenses
search_expensesFinds expenses, with totals and your share
update_expenseChanges an expense found with search_expenses
delete_expenseDeletes an expense. It's marked destructive, so the app asks you first

Over MCP, your default currency is the currency of your latest personal expense, or USD if you have none.

Manage connected apps

Settings → AI assistants lists the apps you've approved. Disconnect revokes an app's access; it has to ask you again to reconnect. Otherwise a connection lasts as long as the app keeps using it: each refresh token is good for 30 days and is replaced every time it's used.

On this page