AI and MCP

How to connect VS Code and GitHub Copilot to SpendixAI with MCP

Connect VS Code and GitHub Copilot to SpendixAI with an mcp.json entry or the MCP: Add Server command. Covers the version note, trust prompt and organisation policy.

Editorial illustration for How to connect VS Code and GitHub Copilot to SpendixAI with MCP

Two dates matter for this setup. GitHub's documentation gives VS Code 1.99 as the minimum version for Copilot's MCP support, and VS Code's own documentation says a legacy Copilot route called the Local harness will be removed in February 2027. Everything else is a short configuration entry.

Check your version and your organisation first

On 11 November 2026 the latest stable VS Code was 1.146, so most up-to-date installs clear the 1.99 bar easily. Our own expense tracker, SpendixAI, only needs a client that supports remote servers and OAuth, and VS Code does both. We checked the details against Microsoft's and GitHub's documentation in November 2026; labels in the editor can change.

Policy is the other thing to check. According to the documentation, Copilot Free, Pro, Pro+ and Max are not governed by the 'MCP servers in Copilot' policy. Copilot Business and Enterprise accounts are governed when the organisation or enterprise sets that policy, and it is disabled by default. If the option is blocked for you, ask your administrator.

Adding the server

  1. Copy the server address from Developer → MCP connections in SpendixAI.
  2. Open the Command Palette and run 'MCP: Add Server'. Choose 'Copilot Global' if you want the entry in your native Copilot user configuration.
  3. Alternatively, create .vscode/mcp.json in a workspace, or edit the mcp.json in your user profile.
  4. In that file, add an entry named spendixai under a servers object, with type set to http and url set to <your SpendixAI server address>.
  5. Start the server. VS Code asks whether you trust it; read the prompt before accepting.
  6. A browser window opens for sign-in. On SpendixAI's consent screen, sign in, choose the workspace and select Read only.
  7. Open Copilot Chat in agent mode and ask a question about your spending.

VS Code tries Streamable HTTP first and falls back to SSE when the type allows it. It attempts dynamic client registration before anything else, which SpendixAI supports, so no client ID is needed. A pre-registered client can be set through an oauth block with a client ID, and the secret is entered through a CodeLens prompt rather than stored in the file. You will not need either for SpendixAI.

Where to keep the entry

A .vscode/mcp.json file sits inside the repository and is often committed. For finance data we would keep SpendixAI in the user-profile or Copilot global configuration instead, so that a repository never advertises a connection to your spending.

LocationFormat noteComment
Workspace .vscode/mcp.jsonTop-level servers objectShared with the repository
User-profile mcp.jsonSame formatApplies to you only
Copilot user configurationTop-level mcpServers objectNative Copilot destination
Workspace-root .mcp.jsonBehind an experimental settingNot recommended for this

Approvals and what SpendixAI allows

VS Code asks you to trust a server when it starts and asks for confirmation on tool actions. We could not confirm from the text we read how finely approvals can be set for individual tools, so approve one call at a time while you are learning.

SpendixAI's own consent screen sets the outer limit. Read only is the recommended preset and covers viewing transactions and reports. 'Read and add' lets the assistant create transactions and upload documents, and 'Full access' also reaches categorisation rules and insights. Billing and member settings are not available, and your workspace role is rechecked on every call.

A command-line shortcut we could not confirm

VS Code has a code --add-mcp option that takes a JSON description with a unique name and adds it to your user profile. The documented example is for a local server. We could not confirm an HTTP example, so we suggest the Command Palette or the file instead.

Questions to try first

  • Total my spending by category for last month.
  • Which days of the month do I spend the most?
  • Show cash expenses I added by hand this quarter.
  • Are any charges repeated to the same merchant within two days?

Treat answers as a starting point. Verify tax-related or reporting figures in the matching SpendixAI report. You can disconnect VS Code at any time from Developer → MCP connections.

SPENDIXAI JOURNAL

Useful ideas start with a clearer picture of your own spending.

Explore your reports