Tallystick MCP
Read e-invoices in your agent
The same parser this site runs, in your agent. XRechnung, ZUGFeRD, Factur-X, UBL, CII, Peppol BIS. Connect to the hosted server in one paste, or run it on your machine so files never leave it.
Two ways to connect
Both are the same server with the same tools and the same key. The hosted one runs here over HTTPS: paste a URL, sign in once, done. The local one runs on your machine over stdio: one install, and your invoices never leave it.
Hosted · HTTPS
The hosted server
One URL and an OAuth sign-in with your Pro or Team key. No config file, no runtime; the browser agents connect here too.
Connect without installingLocal · stdio
The local server
One command, or the MCPB file for Claude Desktop. Reads whole folders, writes Excel, CSV, QBO and PDF; files never leave your machine.
Run it on your machineConnect without installing
One URL, no install. Your agent connects over HTTPS and signs in with OAuth: it opens this site once, you enter your Pro or Team key, and the invoice tools appear. No config file, no runtime, nothing to maintain.
The server URL
https://tally-stick.com/mcp/v1- Add a custom connector in your agent and paste the URL.
- A Tallystick page opens; enter your Pro or Team key once.
- Done. The invoice tools appear in your agent.
Your agent
| Agent | How to connect |
|---|---|
| Claude | Settings, Connectors, Add custom connector. Paste the URL. |
| ChatGPT | Settings, Connectors, turn on Developer mode, then Add connector. Paste the URL. |
| Grok CLI | Run grok mcp add tallystick https://tally-stick.com/mcp/v1. OAuth is handled for you. |
| Gemini CLI | Add the URL under mcpServers in ~/.gemini/settings.json. Sign in when the browser opens. |
| Any other client | Anything that connects to a remote MCP server takes the same URL; use its own add-server step. |
Each call reads or checks one invoice in memory and keeps nothing. Folder exports and PDF output stay with the local server below, where files never leave your machine.
Run it on your machine
The local server runs on your machine over stdio. It reads whole folders, writes Excel, CSV, QBO and PDF, and files never leave it. Claude Desktop on Windows takes the MCPB file; every other client runs one command: uvx tallystick-mcp. Install uv once. No Python project.
Claude Desktop / Windows
MCPB
Includes the runtime. Open the file, paste your key, choose the invoice folder.
Download MCPBCursor / VS Code / Windsurf / Zed / other
One command
uvx tallystick-mcp plus your key in TALLYSTICK_LICENSE_KEY. Config shapes differ by client; pick yours below.
Config
Tools
What your agent can ask for, and which server answers.
| Tool | What it does | Where |
|---|---|---|
detect_invoice_format | Names the format; flags PDFs with embedded XML | Both |
read_invoice | One file to JSON: parties, lines, tax, totals | Both |
validate_invoice | Maths, tax and required fields; each finding coded | Both |
convert_invoice | One invoice as another format's XML; PDF and Excel stay on the REST API | Hosted |
read_invoices_table | A folder as one table, one row per invoice | Local |
export_invoices | Excel, CSV, JSON or QBO from many invoices | Local |
build_einvoice | EN 16931 XML from data, nine profiles | Local |
Key
One key runs both servers. The hosted one asks for it once, on its sign-in page; the local one takes it in the config above. Included in Pro and Team. Browser tools stay free; the server does not.
FAQ
Questions
Which agents can connect?
Any MCP client that speaks remote servers: Claude, ChatGPT, Grok, Gemini CLI, Cursor, VS Code, Windsurf, Zed and others. The hosted server uses OAuth, so connecting is one browser sign-in.
Laptop and desktop?
Pro covers one person on their machines. Team covers five people on one shared key.
Internet?
The local server needs it once, to activate. After that the token checks offline against a key compiled into the package.
Do you store my invoices?
No. On the local server, parsing happens in the process your client started, on your machine. There is no upload path.
Does the hosted connection see my invoices?
Each call's invoice text is processed in memory and dropped when the answer goes back; only the daily fair-use count is kept. If you prefer nothing to leave your machine, the local install above is that path.
I bought the old one-off licence
It still works as sold. Use Find my key with the PayPal transaction id from your receipt.