Norman MCP Server — Claude Code MCP server: features and setup
Connect Claude Code to company records in Norman to draft invoices, sort receipts, and review transactions. It covers accounting workflows for Germany and Poland.
claude mcp add --transport http mcp-server https://mcp.norman.finance/mcpWhat Norman MCP Server does
The server gives an AI assistant access to a company’s Norman records. It can draft invoices and quotes, sort receipts, check transactions, and prepare tax paperwork. Use list_companies and switch_company to move between company records.
German workflows include tax-return previews and submission of supported forms after confirmation. In Poland, the server can show registers and filing status, but it cannot sign or submit returns. That boundary matters if you expect the assistant to file Polish taxes.
Remote access uses HTTP at https://mcp.norman.finance/mcp with OAuth. Claude Code can add the server with claude mcp add; the local option requires NORMAN_EMAIL, NORMAN_PASSWORD, and NORMAN_ENVIRONMENT.
What it helps with
- draft an invoice using company details
- find transactions without receipts
- reconcile bookkeeping entries
- prepare a VAT return preview
- check a Polish filing status
Example prompts for the agent
- Draft a consulting invoice using my company branding.
- Find transactions that have no receipt attached.
- Show my Polish company’s JPK register and explain which operations are excluded.
How to install Norman MCP Server
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.norman.finance/mcp2Platform CLI
claude mcp add --env NORMAN_EMAIL=<NORMAN_EMAIL> --env NORMAN_PASSWORD=<NORMAN_PASSWORD> --env NORMAN_ENVIRONMENT=<NORMAN_ENVIRONMENT> --transport stdio norman-mcp-server -- uvx norman-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from norman-mcp-server <command>
1Platform CLI: remote server
codex mcp add norman-mcp-server --url https://mcp.norman.finance/mcp2Platform CLI
codex mcp add norman-mcp-server --env NORMAN_EMAIL=<NORMAN_EMAIL> --env NORMAN_PASSWORD=<NORMAN_PASSWORD> --env NORMAN_ENVIRONMENT=<NORMAN_ENVIRONMENT> -- uvx norman-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from norman-mcp-server <command>
Config file
{
"mcpServers": {
"norman-mcp-server": {
"url": "https://mcp.norman.finance/mcp"
}
}
}{
"mcpServers": {
"norman-mcp-server": {
"command": "uvx",
"args": [
"norman-mcp-server"
],
"env": {
"NORMAN_EMAIL": "<NORMAN_EMAIL>",
"NORMAN_PASSWORD": "<NORMAN_PASSWORD>",
"NORMAN_ENVIRONMENT": "<NORMAN_ENVIRONMENT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from norman-mcp-server <command>
Config file
{
"servers": {
"norman-mcp-server": {
"type": "http",
"url": "https://mcp.norman.finance/mcp"
}
}
}{
"servers": {
"norman-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"norman-mcp-server"
],
"env": {
"NORMAN_EMAIL": "<NORMAN_EMAIL>",
"NORMAN_PASSWORD": "<NORMAN_PASSWORD>",
"NORMAN_ENVIRONMENT": "<NORMAN_ENVIRONMENT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from norman-mcp-server <command>
1Platform CLI: remote server
gemini mcp add -t http norman-mcp-server https://mcp.norman.finance/mcp2Platform CLI
gemini mcp add -e NORMAN_EMAIL=<NORMAN_EMAIL> -e NORMAN_PASSWORD=<NORMAN_PASSWORD> -e NORMAN_ENVIRONMENT=<NORMAN_ENVIRONMENT> norman-mcp-server uvx norman-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from norman-mcp-server <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Norman MCP Server
How do I install Norman MCP Server in Claude Code?
Add the remote server with claude mcp add --transport http mcp-server https://mcp.norman.finance/mcp, then complete OAuth and choose a company.
What does Norman MCP Server do?
It connects an assistant to Norman company records so it can draft invoices, organize receipts, review transactions, and prepare tax paperwork.
Can Norman MCP Server submit Polish tax returns?
It can display Polish registers and filing status, but cannot sign or submit returns. Supported German filings can be sent after review and explicit confirmation.
