theFinanceStack home

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.

Norman's own documentationMCP serverAPI reference
Norman serves businesses in Germany and Poland. German tax filing goes to the Finanzamt through ELSTER; the Polish tools read estimates and filing status only and don't submit returns.
  • Official MCP serverOfficial remote MCP · read & write
  • Official Claude or ChatGPT connectorClaude 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)
APIAPI
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

OptionWhat it coversReads or writes
Norman MCP server (hosted)Invoices, bookkeeping, documents, bills, payroll, German tax filing, tax registration, company formation, DATEV export, plus Polish registers and estimatesReads 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 feesNo 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 readsReads 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:

ActionWhat happens
Create, then send an invoiceSeparate 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 monthFreezes 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 attachmentRemoves 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.

WhereScopes 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 APIPer-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.

  1. 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.
  2. 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.
  3. Ask the assistant to list your companies and name the one to use, then start with a read request such as unpaid invoices.
  4. 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

DateChangeSource
2026-11-16Norman'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 connectiongithub.com/norman-finance/norman-mcp-server/blob/main/CHANGE
2026-11-02Norman's MCP setup guide updated: Claude custom connector, ChatGPT app, Cursor and other clients, and the public formation servernorman.finance/de/en/help-center/mcp-einrichten
2026-10-20Norman MCP 0.5.0: Polish bookkeeping and JPK reads, complete Ledger and DATEV exports, tax advisor messaginggithub.com/norman-finance/norman-mcp-server/blob/main/CHANGE
2026-09-29Norman's Public API guide updated: per-company keys, read and write permissions, batch document uploadsnorman.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.

Something wrong or out of date? Tell us and we'll email you when it's fixed.

Sources

Vendor list on the CFO Software Market Map courtesy of Jason Staats; AI connectivity data by theFinanceStack. Not tax, compliance or financial advice.