moolaDocs
esc
Open Moola

Connected apps

Connect an assistant

Let Claude or another MCP client read your workspace.

Moola ships a connector: an MCP server that lets an assistant you already use, such as Claude, read your workspace and record plans and bookkeeping on your behalf. Moola runs no model of its own for this. Your assistant, on your subscription, does the thinking.

The connector address is:

https://moola.so/api/mcp

What it can and cannot do

CanCannot
Read accounts, balances, history, transactions, spending summaries, and your Health assessmentMove money or change anything at a bank
Add or update manual accounts, set account kinds, change your milestoneEdit a linked balance
Recategorize transactions and create merchant rulesSee your family workspace or anyone else's data
Save a plan into Health, mark recommendations, and record planned actionsAct without the scopes you approved

Everything the connector can change is something you could change yourself in the app, and every change shows up in Activity.

Connect from Claude

claude.ai, Claude Desktop, or the Claude mobile app

  1. Open Customize → Connectors → Add custom connector.
  2. Paste https://moola.so/api/mcp and continue.
  3. A Moola sign-in page opens. Sign in, then approve the scopes listed on the consent page.

Claude Code

claude mcp add --transport http moola https://moola.so/api/mcp

The first call opens the same sign-in and consent flow in your browser.

Connect from another assistant

Any client that supports MCP over streamable HTTP with OAuth 2.1 can connect. Point it at the address above; Moola supports PKCE and dynamic client registration, so no pre-shared keys are needed. A ChatGPT connector uses the same server; there is no separate ChatGPT-specific code.

Scopes

ScopeGrants
moola:readRead your accounts, balances, history, transactions, and Health score.
moola:writeAdd or update manual accounts, set account types, change your milestone, recategorise transactions, and save plans into Health.
offline_accessStay connected without signing in again for 30 days.

You choose which scopes to grant on the consent page. An app granted only moola:read cannot call any write tool.

Managing connected apps

Settings → Connected apps lists every assistant you have approved, with when it connected. Disconnect stops new access at once; a token already issued expires within 15 minutes.

Calls are limited to 120 a minute per connection.

Try it

A few prompts to start with, once connected:

  • "How is my net worth doing this year, and what moved it?"
  • "Where did my spending go last month compared to the month before?"
  • "Review my financial health and write me a plan."
  • "Mark the emergency-fund recommendation done."