finance.norman/mcp-server

Official

by norman-finance · Python

Norman MCP Server

AI-powered bookkeeping and tax filing for entrepreneurs at the heart of the European economy.

AI-powered bookkeeping and tax filing for entrepreneurs.

Topics

bookkeepingclaudecursor-plugingptinvoicingmcpmcp-servernormanopenaigerman-tax-accountingvat-filing

README.md9 KBView on GitHub

<div align="center"> <a href="https://norman.finance/?utm_source=mcp_server"> <img width="140px" src="https://github.com/user-attachments/assets/d2cb1df3-69f1-460e-b675-beb677577b06" alt="Norman" /> </a> <h1>Norman MCP Server</h1> Your finances, inside your AI assistant. Norman connects your accounting, invoicing, and VAT filing directly to Claude, Cursor, and any MCP-compatible AI. <img src="https://img.shields.io/badge/Protocol-MCP-black?style=flat-square" alt="MCP" /> <img src="https://img.shields.io/badge/Transport-Streamable_HTTP-black?style=flat-square" alt="Streamable HTTP" /> <img src="https://img.shields.io/badge/Auth-OAuth_2.1-black?style=flat-square" alt="OAuth 2.1" /> <img src="https://img.shields.io/badge/License-MIT-black?style=flat-square" alt="MIT" /> <code>https://mcp.norman.finance/mcp</code> Claude  ·  ChatGPT  ·  Cursor  ·  OpenClaw  ·  n8n  ·  Any MCP Client </div> <div align="center">

</div>

What you can do

Invoicing — Create, send, and track invoices including recurring and ZUGFeRD e-invoices

Bookkeeping — Categorize transactions, match receipts, and verify entries

Client Management — Maintain your client database and contact details

Tax Filing — Generate Finanzamt previews, file VAT returns, and track deadlines

Company Overview — Check your balance, revenue, and financial health at a glance

Documents — Upload and attach receipts, invoices, and supporting files

💬 Try asking

Once connected, talk to your books in plain language:

"Prepare and file my UStVA for last month."
"Send a €1,200 invoice to ACME for consulting."
"What did I spend on software this quarter?"
"Find tax deductions I might have missed."
"Which invoices are overdue? Send reminders."

<details open> <summary> <h3>👀 See it in action</h3> </summary> <table> <tr> <td align="center"> Filing a VAT return <img src="https://github.com/user-attachments/assets/00bdf6df-1e37-4ecd-9f12-2747d8f53484" alt="Filing VAT tax report" width="400"> </td> <td align="center"> Transaction insights <img src="https://github.com/user-attachments/assets/534c7aac-4fed-4b28-8a5e-3a3411e13bca" alt="Transaction insights" width="400"> </td> </tr> <tr> <td align="center"> Syncing Stripe payments <img src="https://github.com/user-attachments/assets/2f13bc4e-6acb-4b39-bddc-a4a1ca6787f0" alt="Syncing Stripe payments" width="400"> </td> <td align="center"> Receipts from Gmail <img src="https://github.com/user-attachments/assets/2380724b-7a79-45a4-93bd-ddc13a175525" alt="Creating transactions from Gmail receipts" width="200"> </td> </tr> <tr> <td align="center"> Chasing overdue invoices <img src="https://github.com/user-attachments/assets/d59ed22a-5e75-46f6-ad82-db2f637cf7a2" alt="Managing overdue invoices" width="300"> </td> <td align="center"> Sending payment reminders <img src="https://github.com/user-attachments/assets/26cfb8e9-4725-48a9-b413-077dfb5902e7" alt="Sending payment reminders" width="350"> </td> </tr> </table> </details>

🚀 Get Started

Before connecting, create a free Norman account if you don't have one yet. Log in with your Norman credentials via OAuth — your password never touches the AI.

<details> <summary>Claude Connectors</summary>

Go to claude.ai/settings/connectors
Click Add custom connector
Paste:

code

https://mcp.norman.finance/mcp

</details> <details> <summary>Claude Code</summary>

Norman is available as a Claude Code plugin with built-in skills.

bash

/plugin marketplace add norman-finance/norman-mcp-server
/plugin install norman-finance@norman-finance

Or install directly from GitHub:

bash

claude /plugin install github:norman-finance/norman-mcp-server

</details> <details> <summary>ChatGPT Apps</summary>

Install it from the official ChatGPT Apps Directory.

</details> <details> <summary>Cursor</summary>

</details> <details> <summary>Replit</summary>

</details> <details> <summary>OpenClaw</summary>

Option 1 — Remote with OAuth

Run in OpenClaw:

code

mcp add https://mcp.norman.finance/mcp

You'll be prompted to log in with your Norman account on first use.

Option 2 — Skills only

bash

git clone https://github.com/norman-finance/norman-mcp-server.git
cp -r norman-mcp-server/skills/* ~/.openclaw/skills/
openclaw gateway restart

Option 3 — Local stdio

bash

pip install norman-mcp-server

bash

openclaw mcp add norman -- norman-mcp --transport stdio

Set your credentials as environment variables (NORMAN_EMAIL, NORMAN_PASSWORD) before starting the gateway.

</details> <details> <summary>n8n</summary>

Create an MCP OAuth2 API credential
Enable Dynamic Client Registration
Set Server URL: https://mcp.norman.finance/
Click Connect my account and log in with Norman
Add an MCP Client Tool node to your AI Agent workflow
Set the URL to https://mcp.norman.finance/mcp and select the credential

</details> <details> <summary>Any MCP Client</summary>

Add a remote HTTP MCP server with URL:

code

https://mcp.norman.finance/mcp

</details>

Skills

Ready-to-use skills compatible with Claude Code, OpenClaw, and the Agent Skills standard.

Skill	What it does
`financial-overview`	Full dashboard — balance, transactions, invoices, and tax status
`create-invoice`	Step-by-step invoice creation and sending
`manage-clients`	List, create, and update client records
`tax-report`	Review, preview, and file tax reports with the Finanzamt
`categorize-transactions`	Categorize and verify bank transactions
`find-receipts`	Find missing receipts from Gmail or email and attach them
`overdue-reminders`	Identify overdue invoices and send payment reminders
`expense-report`	Expense breakdown by category, top vendors, and trends
`tax-deduction-finder`	Scan transactions for missed deductions and suggest fixes
`monthly-reconciliation`	Full monthly close — transactions, invoices, receipts, and taxes

Claude Code — /plugin marketplace add norman-finance/norman-mcp-server

Claude Code (local) — claude --plugin-dir ./norman-mcp-server

OpenClaw — cp -r skills/* ~/.openclaw/skills/ && openclaw gateway restart

Have a feature idea? <a href="../../issues">Share your suggestion →</a> <a href="https://glama.ai/mcp/servers/@norman-finance/norman-mcp-server"><img src="https://glama.ai/mcp/servers/@norman-finance/norman-mcp-server/badge" alt="Norman Finance MCP server" width="200" /></a>    <a href="https://mseep.ai/app/norman-finance-norman-mcp-server"><img src="https://mseep.net/pr/norman-finance-norman-mcp-server-badge.png" alt="MseeP.ai Security Assessment" height="41" /></a> <a href="https://norman.finance/?utm_source=mcp_server"> <img width="80px" src="https://github.com/user-attachments/assets/d2cb1df3-69f1-460e-b675-beb677577b06" alt="Norman" /> </a> Make business effortless

Install

Configuration

Environment variables

NORMAN_EMAILrequired

Your Norman account email

NORMAN_PASSWORDrequiredsecret

Your Norman account password

NORMAN_ENVIRONMENTdefault production

API environment: 'production' or 'sandbox'

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "uvx",
      "args": [
        "norman-mcp-server"
      ],
      "env": {
        "NORMAN_EMAIL": "<YOUR_NORMAN_EMAIL>",
        "NORMAN_PASSWORD": "<YOUR_NORMAN_PASSWORD>",
        "NORMAN_ENVIRONMENT": "production"
      }
    }
  }
}