One terminal command and one browser sign-in are enough to let Claude Code read your SpendixAI data. There is no key to generate and no secret stored in a file, which suits a tool that lives next to your source code.
The command
Claude Code treats plain HTTP as the recommended transport for remote servers and describes SSE as deprecated. The command is claude mcp add, followed by the option --transport http, the name you want to use (we use spendixai here) and the address. In your terminal, the address goes in place of <your SpendixAI server address>. You will find that address in SpendixAI under Developer → MCP connections, with a copy button beside it.
Step by step
- Copy the server address from Developer → MCP connections in SpendixAI, the expense tracker we build.
- Run the add command above in a terminal, with the transport set to http and the name spendixai.
- Start Claude Code and type /mcp.
- Choose the SpendixAI server and start authentication. Your browser opens.
- Sign in to SpendixAI, pick the workspace and select the Read only preset.
- Return to Claude Code and ask a first question about your spending.
If you prefer the shell to the /mcp menu, claude mcp login spendixai starts the same browser flow and claude mcp logout spendixai ends it. Claude Code keeps the tokens securely and refreshes them by itself. Choosing 'Clear authentication' in /mcp removes the sign-in again. This guide was checked against Claude Code's documentation in November 2026; commands and menus can shift between releases.
Where the setting is stored
Add a scope option to the command to decide who gets the connection. For finance data we would pick user or leave the default, because a shared project file puts the entry in front of everyone who clones the repository. Nothing secret is in it, but each teammate would then see a SpendixAI entry they may not expect.
| Scope option | Reach | Stored in |
|---|---|---|
| --scope local (default) | Only the current project, only you | Your personal Claude Code settings file |
| --scope project | Everyone who uses the project | .mcp.json in the project root |
| --scope user | All your projects | Your personal Claude Code settings file |
Flags you can ignore
Claude Code also accepts a header flag, a client ID and a client secret. They exist for servers that use fixed credentials. SpendixAI registers clients dynamically through its OAuth flow, so none of them are needed, and you should never paste a secret into a command line for this connection. The callback-port option is for servers with a pre-registered redirect and is not part of a normal SpendixAI setup.
Permissions: SpendixAI's and Claude Code's
SpendixAI's consent screen offers three presets. Read only (recommended) covers viewing transactions and reports. Read and add can also create transactions and upload documents. Full access reaches categorisation rules and insights as well. Billing and member settings stay in the SpendixAI console no matter what you pick. Your workspace role also caps the assistant, and access is checked again on every call.
Claude Code routes MCP tool calls through its own permission prompts. We could not extract the exact wording from the documentation, so read each prompt before you approve it and avoid blanket approvals while the connection can write.
Good first questions
- Summarise my spending for the last full month by category.
- List my ten largest transactions this year.
- Which merchants appear most often in my statements?
- Show recurring charges I may have forgotten about.
Compare anything you will rely on, particularly tax figures, with the corresponding SpendixAI report. Claude Code is a developer tool and often runs inside a project folder, so keep spending questions to a session of their own rather than mixing them with work on a codebase.
Details we could not confirm
The page we read does not state a minimum Claude Code version or a plan requirement. Exact permission-prompt wording for MCP tools was also not confirmed. To disconnect, use Developer → MCP connections in SpendixAI, which lists every connected assistant.
Useful ideas start with a clearer picture of your own spending.
Explore your reports


