Connect your AI tools to SparkReceipt with MCP

You can connect an outside AI assistant — such as Claude or Cursor — straight to your SparkReceipt account and have it work with your documents for you. Ask it to pull up last month's expenses, tag a batch of receipts, create a new category, or upload a receipt for scanning, all from inside the AI tool you already use.

This works over MCP (Model Context Protocol), an open standard that lets AI tools talk to services like SparkReceipt. You don't need to know how it works under the hood — you add one address to your AI tool, sign in once, and choose what it's allowed to do.

The assistant acts as you, with your role's permissions. It only ever sees and changes your own data, and it can never do more than your account role allows.

If you'd rather chat with an AI assistant inside SparkReceipt itself — no setup, no external tools — see How to use SparkAgent. MCP exposes the same set of actions SparkAgent uses, but from your own AI tool.

What you can connect

MCP works with any AI tool that supports remote MCP servers. SparkReceipt gives you setup instructions for three:

Claude Code — Anthropic's command-line tool. This is the most straightforward to connect: it's a single terminal command.
Cursor — the AI code editor. You add SparkReceipt as an MCP server in Cursor's settings.
Claude Desktop — the Claude desktop app. You add SparkReceipt as a custom connector.

Other MCP-capable tools connect the same way: they all point at the same SparkReceipt address and sign in through your browser. If your tool isn't listed above, use the Cursor or Claude Desktop steps as a template — add the Server URL as a remote MCP server and follow your tool's own prompts.

Where to find it

Open Settings in the SparkReceipt web app and select the MCP tab. Everything you need is here:

The Server URL to add to your AI tool.
Setup instructions for each supported tool.
Connected apps — the tools you've already connected, with an option to disconnect any of them.
View activity log — a record of everything your connected tools have done.

Connecting an AI tool is a per-user action. The connection belongs to you personally, not to the whole account, and every action it takes runs with your own role's permissions.

How to connect

Every tool follows the same shape: add the SparkReceipt Server URL, then trigger the first action so your browser opens the sign-in and permissions screen.

The Server URL is shown on your MCP settings page. It looks like:

https://api.app.sparkreceipt.com/mcp

Always copy the exact URL from your own MCP page rather than typing it by hand — the setup snippets below already have it filled in for you.

Claude Code

Run this in your terminal to add the server (copy the exact command from your MCP page, which has your URL filled in):
```
claude mcp add --transport http sparkreceipt https://api.app.sparkreceipt.com/mcp
```
Trigger any SparkReceipt action. Claude Code opens your browser so you can sign in and pick which permissions to allow.
Ask it to list your recent expenses to confirm the connection works.

Cursor

Open Cursor settings, go to MCP, and add a new server (or edit your mcp.json) with this entry:

{
  "mcpServers": {
    "sparkreceipt": {
      "url": "https://api.app.sparkreceipt.com/mcp"
    }
  }
}

Cursor opens your browser so you can sign in and choose which permissions to grant.

Claude Desktop

Open Claude Desktop settings and add a custom connector.
Paste the Server URL from your MCP page as the connector address and confirm.
Sign in and choose which permissions to grant in the browser window that opens.

Signing in and granting permissions

The first time your AI tool contacts SparkReceipt, a browser window opens with a Connect to SparkReceipt screen. This is where you approve the connection.

If you're already signed in to SparkReceipt in that browser, you go straight to a single approval screen showing your account and the permissions to grant.
If you're not signed in, you'll be asked to sign in first, then brought right back to the same screen.

On the approval screen you choose two things: which accounts to connect and which permissions to grant. Then select Authorize to finish, or Cancel to stop.

Sign-in uses a secure standard (OAuth 2.1). Your AI tool never sees your SparkReceipt password — you enter it in your own browser, on SparkReceipt's own page.

The three permission levels

Permissions are grouped into three levels. You tick each one independently on the approval screen — granting one does not automatically grant the others. Grant only what you need.

The labels below are exactly what you'll see on the approval screen.

Permission	What it allows
Read your data	View your data — receipts, tags, saved searches, and reports.
Create and update data	Create and edit data — receipts, tags, and saved searches.
Irreversible actions	Actions that can't be undone, including permanently deleting your data.

A few things worth knowing:

Irreversible actions is never pre-selected, and it carries a warning: these actions cannot be undone, and you're responsible for what your connected AI tool does with this permission. Only grant it if you specifically want the tool to be able to delete data.
Permissions are enforced both when the tool lists what it can do and every time it tries to act. If you didn't grant Create and update data, editing tools simply aren't available to the assistant — it can't work around it.
To change what a connection can do later, disconnect it and reconnect with the permissions you want.

Choosing which accounts to connect

If you belong to more than one account (for example a personal account and a company one, or several linked accounts), the approval screen lets you decide the scope:

All my accounts — the connection can reach every account you're a member of.
Specific accounts — tick only the ones you want, and the connection is limited to those.

Every action the assistant takes targets one specific account. When a connection spans more than one account, ask your assistant to look up your accounts first (it uses a built-in account_info action for this) and then tell it which account to work in.

What you can do once connected

Once connected, your AI tool can use the same set of actions that power SparkAgent — over 90 of them — plus two that are specific to MCP. You don't call these directly; you ask your assistant in plain language and it picks the right ones.

Some examples of what you can ask:

Find and review documents — "List my expenses from July over 100 euros" or "Show me any documents missing a category."
Tag and organize — "Tag every Uber receipt this month as Travel."
Set up your books — "Create a category called Software subscriptions," "Add a new merchant," or "Add a payment method for my company credit card."
Manage automations — "List my automations" or "Set up a rule that tags receipts from this sender."
Check account details — "Which accounts can you access, and what's my role in each?"
Reconcile and report — "Match this bank statement against my receipts" or "Build a report of this quarter's expenses."

Uploading a document for scanning

One MCP action has no equivalent inside the app: submit a document. Your assistant can send a receipt, invoice, or bank statement file to SparkReceipt, and it runs through the same OCR and AI extraction pipeline as any upload from the web or mobile app.

Things to know about uploading this way:

You can submit 1 to 5 files as a single document (useful for a multi-page invoice), up to 15 MB each.
You can tell it the type — expense, income, or bank statement — or leave it out and let the AI classify the document for you.
Each submission uses one scan from your account's quota, exactly like a normal upload.
Extraction runs in the background. Your assistant gets a task reference it can use to check progress.
It's reversible: trashing the document undoes the submission.

Managing and disconnecting

The Connected apps section on the MCP page lists every tool you've connected, along with the permissions it holds, which accounts it can reach, when you connected it, and when it was last used.

Select Disconnect on any connection to revoke its access immediately. Do this for any tool you no longer use — or any you don't recognize. To use a disconnected tool again later, you'll need to sign in and grant permissions afresh.

Keeping an eye on activity

Select View activity log to see every action your connected assistants have taken on your behalf, newest first. Each entry shows the time, the action, whether it succeeded or failed, and the details. It's the place to check what happened and to troubleshoot when something didn't work as expected.

Privacy and security

The assistant is you. It's tied to your user and limited to your role's permissions, so it can only see and change data you could see and change yourself.
Nothing happens without your consent. You choose the accounts and the permission levels when you connect, and destructive access is always a separate, deliberate opt-in.
Your password stays with you. Sign-in happens in your own browser on SparkReceipt's page; the AI tool only receives a limited access token, never your credentials.
You're in control at all times. Disconnect a tool whenever you want and its access ends immediately, and the activity log shows you exactly what was done.
You're responsible for the tool you connect. SparkReceipt enforces the permissions you grant, but the AI tool decides which actions to take within them — especially if you grant irreversible actions. Only connect tools you trust, and grant the minimum you need.

Troubleshooting

No MCP tab in settings. MCP is rolling out gradually and may not be enabled for your account yet. There's nothing to switch on yourself — it appears once it's available to you.
The assistant can't do something you expected. Check that you granted the matching permission when you connected. Editing needs Create and update data; deleting needs Irreversible actions. If a permission is missing, disconnect and reconnect with it enabled.
It doesn't know which account to use. If you connected more than one account, tell your assistant which account to work in, or ask it to list your accounts first.
An action failed. Open View activity log to see the error details for that action.
You want to cut off access fast. Disconnect the tool from the Connected apps section — access ends right away.

How to use SparkAgent – Introduction and examples — the same actions, from an AI assistant built into SparkReceipt.
Is it safe to connect an AI tool to my SparkReceipt account? — the short answer on privacy and control.