> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kualia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Connect Kualia to Claude Code, the CLI and IDE coding assistant

<img src="https://mintcdn.com/kualia/dQHAV5g5PLKK3onV/images/mcp/claude.svg?fit=max&auto=format&n=dQHAV5g5PLKK3onV&q=85&s=d5d905d4d5d9cabba3c07df83a09361e" alt="Claude Code" width="64" height="64" data-path="images/mcp/claude.svg" />

[Claude Code](https://claude.com/claude-code) can use Kualia as an MCP server so you can ask it to query your budget while you're in the terminal or your IDE.

## Add the connector

The fastest way is the `claude mcp add` command:

```bash theme={null}
claude mcp add --transport http kualia https://api.kualia.com/mcp
```

That registers Kualia as an HTTP MCP server in your user-level config.

Alternatively, use the in-app UI:

<Steps>
  <Step title="Open the MCP menu">
    In Claude Code, run `/mcp` (or open **Settings → Connectors** in the desktop app).
  </Step>

  <Step title="Add a server">
    Choose **Add server**, set the transport to **HTTP**, and enter:

    * **Name**: `kualia`
    * **URL**: `https://api.kualia.com/mcp`
  </Step>

  <Step title="Authenticate">
    Run `/mcp` again and select **Kualia → Connect**. Your browser opens the Kualia app for OAuth consent. Once you approve, the token is stored locally.
  </Step>
</Steps>

## Scope: user, project, or local

When adding the server you can pick a scope:

* **User** (default for the command above): available in every project on this machine.
* **Project**: writes to `.mcp.json` in the repo so collaborators can use it too. Add `--scope project`.
* **Local**: only this machine, this project. Add `--scope local`.

```bash theme={null}
claude mcp add --transport http --scope project kualia https://api.kualia.com/mcp
```

## Try it

```text theme={null}
> what categories am i overspending in this month?
> list my last 20 transactions tagged "subscriptions"
> assign $200 to Groceries for May
```

## Manage and disconnect

* `claude mcp list` — show configured servers
* `claude mcp remove kualia` — remove the server
* Inside a session, `/mcp` shows status and lets you reconnect or sign out.