If you already use Droid, the coding agent from Factory, in your terminal, you can point it at your expense records and ask questions in plain English. This guide covers only the connection, in the order you will meet it on screen.
A note on who is writing: SpendixAI is our own product, so this is a how-to and not an independent review. Everything below follows what Factory documents for adding a remote MCP server that signs in with OAuth.
Before you start
- Droid installed and working in your terminal.
- A SpendixAI workspace, which you open with your Google sign-in.
- A browser on the same machine, because the sign-in happens there.
- The server address, shown under Developer → MCP connections in SpendixAI with a copy button next to it.
You do not need an API key. SpendixAI uses a consent screen, so there is no secret to paste into a file and nothing to leak from a config.
Step by step
- Copy the server address from Developer → MCP connections.
- In your terminal, run the add command described in the next section.
- Start Droid and open /mcp. Complete the browser sign-in that appears for the spendixai server.
- On the SpendixAI screen, sign in, choose your workspace and pick Read only.
- Back in Droid, ask a first question, such as what you spent on groceries last month.
The command in plain words
The command starts with droid mcp add, followed by the name spendixai, then <your SpendixAI server address>, then the flag --type http. Replace the placeholder with the address you copied. Until the sign-in is finished, droid mcp list shows the server as needing authentication. That is the normal waiting state, not an error.
Droid keeps its servers in a user file under the .factory folder in your home directory, or in a project file inside a repository. Factory describes the project file as one you commit, so we would not put a personal finance server there.
Approvals and what Droid may do
Factory's documentation says approval of an MCP tool can be remembered across sessions and is tied to the server address. You can inspect and undo remembered approvals with droid mcp permissions list, revoke and clear. How often Droid asks before using a tool depends on your autonomy level, and we could not confirm the exact default in the pages we read.
At a glance
| Item | What to know |
|---|---|
| Transport | HTTP, set with the --type flag |
| Sign-in | Browser sign-in from /mcp; SpendixAI consent screen |
| Stored credentials | System keyring, or a fallback file, per Factory |
| Plan or version | Not stated on the page we read |
| Default tool prompts | Depends on autonomy level; exact default not confirmed |
| Disconnect | Clear Auth in /mcp, or Developer → MCP connections |
Choosing a permission preset
The SpendixAI consent screen offers three presets. Whatever you pick, Droid never gets more than your own workspace role allows, and SpendixAI checks that again on every call, so a member who is demoted later loses access.
- Read only: view transactions and reports. This is the recommended start.
- Read and add: also create transactions and upload documents, which helps for cash spends you would otherwise type in yourself.
- Full access: also categorisation rules and insights.
Billing and member settings are not available to any assistant. They stay in the SpendixAI console, so Droid cannot reach them even on Full access. If you later want a different preset, disconnect and sign in again.
What to ask first
Good opening questions are ones you can check by eye: what you spent on food last month compared with the month before, which merchants you paid most often this quarter, or which recurring charges you have and what each costs per year. Droid answers from the records in your workspace, which come from statements you uploaded and expenses you typed in, because SpendixAI has no bank connection.
If something does not work
- Still shows needing authentication: open /mcp again and finish the browser step.
- Browser did not open: check that you are running Droid on a machine that has a browser.
- Wrong workspace: disconnect in SpendixAI, then repeat the sign-in and choose again.
- Answers look off: check important figures in the matching SpendixAI report, since the assistant's provider produces the wording.
We checked this setup against Factory's documentation in November 2026. Menus and commands change, so if a step does not match what you see, follow Factory's current guide.
Useful ideas start with a clearer picture of your own spending.
Explore your reports


