Codex keeps its MCP settings in one place that the command line, the editor extension and the desktop app all read. Add SpendixAI once and the same connection shows up in each, which is convenient and worth remembering when you decide how much access to grant.
Three ways to add the server
As the team behind SpendixAI, we checked these routes against OpenAI's Codex documentation in November 2026. Docs move, so treat command names as current at that date. In every route, the address to use is the one under Developer → MCP connections in SpendixAI.
From the command line
Run codex mcp add with the name spendixai and a --url option pointing at <your SpendixAI server address>. Then codex mcp list confirms the entry exists. Codex also has --oauth-client-id and --oauth-client-secret options for pre-registered clients. SpendixAI registers clients itself, so skip both.
In the configuration file
Edit the Codex config.toml in your home folder, or the project-level one inside a trusted project. Add a table named mcp_servers.spendixai with one key, url, set to <your SpendixAI server address>. The auth setting defaults to oauth, so you do not set it.
In the IDE extension
Open the gear menu, choose MCP servers, then Add server and pick Streamable HTTP. Enter the address, save, restart the extension and choose Authenticate.
Signing in
- Add the server by one of the routes above.
- Run codex mcp login spendixai. Your browser opens on a SpendixAI consent screen.
- Sign in, choose the workspace and select the Read only preset.
- On a machine with no browser, add --no-browser, open the link elsewhere and paste the redirect address back into the terminal.
- Ask a simple question to confirm the connection works.
Codex also lets you override scopes per login. For SpendixAI the scope comes from the preset you choose on the consent screen, so we would not use that override to widen access. ChatGPT on the web does not read your local Codex configuration; connect it separately if you want it there.
Approval modes for money data
Codex has a default_tools_approval_mode setting with four values: auto, prompt, writes and approve. In the writes mode, Codex prompts for tools that are not marked read-only. The prompt mode asks every time. For a finance connection, writes or prompt is the sensible choice. You can also override the mode for one tool, and list tools in enabled_tools or disabled_tools to restrict what Codex may call at all.
| Mode | Behaviour | Fit for SpendixAI |
|---|---|---|
| auto | Runs without asking | Not recommended |
| prompt | Asks before tools run | Good while learning |
| writes | Asks for tools not marked read-only | Good for everyday use |
| approve | Value described in the documentation; we did not confirm its exact effect | Check before using |
What SpendixAI itself limits
Read only lets an assistant view transactions and reports. Read and add can create transactions and upload documents. Full access adds categorisation rules and insights. Billing and member settings stay out of reach for every preset, and your workspace role is checked on each call. The Developer → MCP connections page shows connected assistants and lets you disconnect one whenever you like.
What to ask first
- What did I spend last month?
- Which category took the largest share of my spending this year?
- Which merchants charged me more than once in a week?
Check figures you will rely on, such as tax estimates, in the matching SpendixAI report before acting on them.
Because the same configuration serves the terminal, the editor and the desktop app, a connection added in one place is live in all of them. If you only meant to try SpendixAI in one tool, keep an eye on where else Codex is open, and set the approval mode before you start rather than after.
What we could not confirm
The Codex page we read states no plan requirement and no minimum CLI version, so we cannot say whether either applies. The default startup timeout for a server is 10 seconds according to the documentation, which matters only if the connection is slow.
Useful ideas start with a clearer picture of your own spending.
Explore your reports


