Norman MCP server and API: what it does, what it can change, how to connect
Norman runs an official hosted, read-write MCP server for its German and Polish bookkeeping app, with OAuth sign-in, a Claude and ChatGPT listing and a separate REST API.
- Official remote MCP · read & write
- Claude and ChatGPT directory listings
- Hosting
- Remote HTTP only (Streamable HTTP), hosted by Norman at https://mcp.norman.finance/mcp. The official MCP registry entry, finance.norman/mcp-server, points to that address. Norman's MIT-licensed GitHub repo holds docs, skills and client manifests; Norman says the server source is now private and its local PyPI package is no longer updated.
- Auth
- OAuth 2.1 sign-in through Norman in the browser, with dynamic client registration. You pick the company to work with; Norman says your password stays on its sign-in page.
- Read / write
- Read and write. Tools create and send invoices, categorize and delete transactions, approve payroll, start a SEPA bill payment and submit German tax returns to the Finanzamt via ELSTER. Norman says filing and payments need your explicit approval.
- Works with
- Claude (directory connector, custom connector, Claude Code plugin), ChatGPT (plugin directory), Cursor, n8n, Gemini CLI and other MCP clients with OAuth, per Norman.
- Plan requirement
- MCP access is on Norman's Free plan, per Norman, but some uses need a paid plan. Self-employed: tax filing from Klein at €9 a month billed yearly (€12 monthly; EÜR and income tax on yearly billing only). UG and GmbH: DATEV export and tax-advisor access on Pro (€9 a month yearly, €12 monthly); every tax filing and annual accounts on Max (€39 a month yearly, €52 monthly). Payroll is a paid UG/GmbH feature with no price listed. Prices exclude VAT. These are Norman's German plans; Polish plans and limits differ, per Norman.
- Last changed
- 2026-11-02: Norman's MCP setup guide updated (Claude, ChatGPT, Cursor and other clients)
- API
- REST over HTTPS (https://api.norman.finance/api/v1/), JSON with camelCase fields and paginated lists. OpenAPI JSON on request from Norman support · Bearer API key bound to one company, with separate read and write permissions (for example read_transactions, write_invoices) or full_access, and an expiry you set · Webhooks: Norman's developer overview mentions webhooks; the Public API guide doesn't document events or how to subscribe · Self-serve. Create a named key in Norman under Automations > Integrations > Public API. Payments, bank authorization and tax filing are not in the Public API, per Norman. Rate limits answer 429 with Retry-After · API docs
- Verification
- Verified 16 Nov 2026 by theFinanceStack · confidence: high
What can an agent do with Norman through MCP?
It runs the bookkeeping, invoicing and German tax work in a Norman company: reading records, drafting and sending invoices, matching receipts, running payroll and filing supported returns with the Finanzamt, which Norman says happens only after you approve. Norman's GitHub tool list counts 312 tools; its MCP page says 240+.
Where it runs
| Option | What it covers | Reads or writes |
|---|---|---|
| Norman MCP server (hosted) | Invoices, bookkeeping, documents, bills, payroll, German tax filing, tax registration, company formation, DATEV export, plus Polish registers and estimates | Reads and writes, including ELSTER filing and SEPA bill payments after approval |
| Norman public formation server (norman.finance/api/calculators/mcp) | Plans a UG or GmbH formation: legal form, articles, minimum deposit and estimated notary fees | No sign-in and no account data; nothing is saved until you continue in Norman, per Norman |
| Norman Public API (custom build) | Company details, transactions, bank connections, clients, products, invoices, recurring invoices, documents and OCR, tax report reads | Reads and writes records; no payments, bank authorization or tax filing |
What the MCP tools cover
Norman groups the tools by task. Group sizes are Norman's, from its MCP page.
- Invoices and offers (14): create, send and track invoices, recurring invoices and ZUGFeRD e-invoices.
- Bookkeeping (8): categorize and verify transactions and map them to an SKR account.
- Taxes and filing (10): prepare, preview and submit VAT returns (UStVA), EÜR and prepayments.
- Payroll (31): calculate and approve the month, social insurance contributions, payslips and the Lohnsteuer-Anmeldung.
- Bills and payments (6), clients and vendors (10), documents (7), tax registration (12), company formation (37), and company data and exports (12).
- 22 ready-made skills ship with the server, such as monthly reconciliation and overdue reminders.
What happens when it writes
Per Norman's tool list and MCP pages:
| Action | What happens |
|---|---|
| Create, then send an invoice | Separate steps. send_invoice emails the invoice or quote to the client at once, with the PDF attached; Norman's tool list shows no confirmation step. |
| Verify or finalize a transaction (change_transaction_verification) | Finalizes or unfinalizes the booking straight away; it isn't a draft. |
| Link a transaction to an invoice (link_transaction) | Records the payment against the invoice and finalizes the transaction. |
| Approve a waiting automation (approve_rule_execution) | Runs the rule's full action chain, which can set categories and VAT and send reminder emails. Norman's tool list says to call it only after you confirm. |
| File a German tax return (submit_tax_report) | Goes to the Finanzamt through ELSTER, after a test preview (generate_finanzamt_preview). Norman says submission is a separate, confirmed action on a paid plan. |
| File the Lohnsteuer-Anmeldung (submit_wage_tax_return) | Files the payroll tax return through ELSTER. Norman's tool list calls it binding. |
| Approve a payroll month | Freezes the month's version and books it to the ledger. |
| Pay a bill (pay_bill, Germany only) | Starts a real SEPA payment and returns a link that you open to authorise the payment with your bank. |
| Delete a transaction, client, vendor, bill or attachment | Removes the record; Norman's tool list says deleting a transaction happens after confirmation. |
Poland
For Polish companies, Norman says the MCP tools read tax estimates, registers and existing JPK filing status; some of those reads also refresh derived records. They don't sign or submit Polish returns or make tax and ZUS payments.
Can
- Read transactions, invoices, bills, clients, balances and tax status for the selected company
- Create and send invoices, quotes, recurring invoices and ZUGFeRD e-invoices
- Categorize, verify and match transactions and receipts, and upload documents
- Prepare a Finanzamt preview and submit supported German returns (UStVA, EÜR, prepayments) via ELSTER after approval
- Calculate, approve and file German payroll for a UG or GmbH, including the Lohnsteuer-Anmeldung (a paid feature, per Norman)
- Start a SEPA payment for a bill, authorised by you at your bank (Germany only)
- Trigger a DATEV export (UG and GmbH Pro plan) and start a guided UG or GmbH formation
Cannot
- Sign or submit Polish tax returns, or pay Polish taxes or ZUS (per Norman)
- File a tax return on the Free plan; filing needs an eligible paid plan (per Norman)
- Complete a company formation by itself: notary and authority steps stay separate (per Norman)
- Assume a company: Norman says to list your companies, name the one to use and check it before changing its books
What access does it get?
The MCP connection acts as your Norman user in the company you choose, with the actions your account, permissions and plan allow. A Public API key is bound to one company and carries only the read and write permissions you give it.
| Where | Scopes and permissions (as documented) | Admin requirement |
|---|---|---|
| Norman MCP server (Claude, ChatGPT, other clients) | Not documented by the vendor for choosing at sign-in. Norman's OAuth metadata lists read and write scopes, and Norman says its API enforces access and action permissions. Norman doesn't document a read-only connection, so limit writes with your AI client's per-tool approval. | Not documented by the vendor. Claude Team/Enterprise: an Owner adds connectors for the organization. ChatGPT Business/Enterprise: a workspace admin may need to enable the app first. Disconnect in the AI client to stop the connection. |
| Norman Public API | Per-key permissions, read and write separate (read_transactions, write_invoices and so on), presets such as Read only and Invoicing, or full_access for the key's company. | Not documented by the vendor beyond key creation in Automations > Integrations > Public API. Access also depends on the key creator's current account and company access. |
How do I connect it?
Add Norman from the Claude or ChatGPT directory, or add https://mcp.norman.finance/mcp as a remote server, then sign in to Norman and confirm the company. There is no maintained local server.
Which clients work: Claude.ai and Claude Desktop, Claude Code, ChatGPT.
- Option 1, per Norman: open the Norman listing in the Claude connector directory (claude.ai/directory/connectors/norman-finance), click connect and log in with your Norman account.
- Option 2, per Norman: open Settings > Connectors, add a custom connector with https://mcp.norman.finance/mcp and complete Norman's authorization in the browser.
- Ask the assistant to list your companies and name the one to use, then start with a read request such as unpaid invoices.
- Team/Enterprise: an Owner adds the connector first.
Norman says availability depends on your Claude client, plan and workspace.
What should a finance team watch for?
This server can file German tax returns, approve payroll and start bank payments, so keep a person approving every write and every filing.
- Binding actions: submit_tax_report and submit_wage_tax_return file with the tax office through ELSTER, and approving a payroll month books it to the ledger. Review the preview, company and period first; Norman says submission is a separate action.
- Money movement: pay_bill starts a real SEPA payment. Norman returns a bank authorisation link, so the payment still needs your bank's approval, but treat the tool call as a payment request.
- Deletes: tools delete transactions, clients, vendors, bills, attachments and automation rules. Norman says some deletes ask for confirmation first; keep your AI client's tool approval on.
- Company selection: Norman says to confirm the selected company before changing its books, and not to assume another client carried over the company you used last.
- Prompt injection: a receipt, client note or email the assistant reads could carry hidden instructions to send an invoice, pay a bill or file a return. Don't set write tools to always allow.
- Data: Norman says its accounting data is stored in Germany under GDPR and GoBD, and that it doesn't use your data to train AI models. Data your assistant retrieves is processed by your AI provider under its own terms, so read those too.
- Local server: Norman's MCP page still mentions a pip package for stdio, but Norman's changelog says that package is no longer updated. Use the hosted connection.
- Public API keys for a custom build: start with the Read only preset or the narrowest permissions and a short expiry, avoid full_access, and keep the key in your server environment or automation tool's credential store, as Norman advises. Never paste it into a chat.
- Tool counts differ: Norman's GitHub tool list says 312 tools, its MCP page says 240+. Ask the assistant which tools it can see before relying on one.
How could finance teams and accounting firms use it?
Reads suit status questions and month-end checks; writes suit invoice drafts, receipt matching and tax previews that a person reviews before anything is sent, paid or filed.
Inside a company
- List unpaid invoices with numbers, amounts and due dates, and draft reminders for a person to send.
- Find transactions with missing receipts and attach the documents you upload.
- Prepare the VAT return preview for the period and review it before filing.
- For a UG or GmbH on a paid plan: run the month's payroll calculation and check it before approving.
At an accounting firm
- For a German client on Norman, summarise open items, unmatched transactions and tax status before a review call.
- Prepare UStVA previews for review, keeping submission with the client or the responsible advisor.
- Trigger a DATEV export (UG and GmbH Pro plan) to hand the books to a Steuerberater.
Keep a person approving anything that sends an invoice, pays a bill, approves payroll or files with the tax office.
Want Norman connected to Claude for your team?
We set up the connection with a review step before anything is sent, paid or filed. Fixed fee.
Change log
| Date | Change | Source |
|---|---|---|
| 2026-11-16 | Norman's changelog (unreleased section, read 16 Nov 2026): server source moved to a private repository; the local PyPI package is no longer updated, so use the hosted connection | github.com/norman-finance/norman-mcp-server/blob/main/CHANGE |
| 2026-11-02 | Norman's MCP setup guide updated: Claude custom connector, ChatGPT app, Cursor and other clients, and the public formation server | norman.finance/de/en/help-center/mcp-einrichten |
| 2026-10-20 | Norman MCP 0.5.0: Polish bookkeeping and JPK reads, complete Ledger and DATEV exports, tax advisor messaging | github.com/norman-finance/norman-mcp-server/blob/main/CHANGE |
| 2026-09-29 | Norman's Public API guide updated: per-company keys, read and write permissions, batch document uploads | norman.finance/de/en/help-center/public-api |
FAQ
Is this official?
Yes. Norman documents the MCP server on its own site and GitHub, lists it in the Claude and ChatGPT directories, and publishes it in the official MCP registry as finance.norman/mcp-server.
Is it free?
Norman says the MCP connection, invoicing and bookkeeping are on its Free plan. Tax filing and some company features need a paid plan, from €9 a month billed yearly, excluding VAT; payroll is a paid UG and GmbH feature with no price listed. These are Norman's German plans; Polish plans differ. Your AI plan still applies.
Does it change data in Norman?
Yes. It creates and sends invoices, changes and deletes records, approves payroll, starts SEPA bill payments and files German returns via ELSTER. Norman says filing and payments wait for your approval.
Is my data used to train models?
Norman says it doesn't use your data to train AI models and stores accounting data in Germany. Your AI provider processes what the assistant retrieves under its own terms, so check those.
Can my accountant use it on my behalf?
Norman's tool list says a signed-in tax advisor can see the companies they advise, but Norman doesn't document how that access is granted. The accountant signs in with their own Norman account, never yours.
Sources
- Norman: MCP connection (endpoint, clients, tool groups, pricing, FAQ)
- Norman help center: connect Norman to an AI assistant with MCP
- Norman MCP server on GitHub (MIT)
- Norman MCP server: full tool list
- Norman MCP server: connecting clients (Claude Code plugin, ChatGPT, Gemini)
- Norman MCP server changelog (hosted only; PyPI package no longer updated)
- Norman MCP OAuth metadata (scopes, dynamic client registration)
- Claude connector directory: Norman
- ChatGPT plugin directory: Norman
- Norman for developers (API overview, webhooks mention)
- Norman Public API documentation
- Norman help center: Public API (keys, permissions, errors)
- Norman AI (approvals, data location, no training)
- Norman: plans and pricing
- Norman: llms.txt (Germany and Poland scope)
Vendor list on the CFO Software Market Map courtesy of Jason Staats; AI connectivity data by theFinanceStack. Not tax, compliance or financial advice.