What is the Kualia MCP server?
Kualia exposes a remote Model Context Protocol (MCP) server so AI assistants like Claude, ChatGPT, Cursor, and Perplexity can read your budget data and help you reason about your finances — directly, with your permission, and without copy-pasting. Server URLWhat can the AI do?
Once connected, the assistant can call these tools on your behalf:| Tool | What it does |
|---|---|
list_workspaces | List the workspaces you have access to |
list_transactions | Search and filter your transactions |
list_recurring_transactions | List your recurring transactions |
list_category_groups | List your envelope category groups |
list_category_targets | List your category targets |
get_envelope_month_status | See assigned, activity, and available for a month |
get_category_rollup | Roll up spending by category |
get_spending_report | Generate a spending report |
get_income_summary | Summarize income for a period |
get_account_balances_report | Report balances across accounts |
set_category_assigned_amount | Assign money to a category |
How authentication works
You never paste an API key. The connection uses OAuth 2.1 with PKCE and dynamic client registration, all driven by the MCP spec:- The client connects to
https://api.kualia.com/mcp. - Kualia responds with a
WWW-Authenticateheader pointing to its OAuth metadata. - The client opens the Kualia app in your browser to ask for consent.
- You approve, and the client receives a token scoped to your account.
- The token is stored locally by the client and used for all future calls.
Pick your client
Claude (web & desktop)
Claude Code
Claude Cowork
Cursor
ChatGPT
Perplexity
Other clients
Privacy
- Kualia only returns data for workspaces your account has access to.
- Tokens are stored by the client (e.g. on your laptop), not by the assistant provider.
- To disconnect, remove the connector from your AI client’s settings.