Norman Finance MCP Server

Integrations

Supports configuration through .env files to store and manage Norman Finance credentials and environment settings.
Allows importing receipts from Cloudflare into the Norman Finance system, demonstrated in the Gmail receipts example.
Provides access to installation from source via GitHub repository, with examples linking to attachments hosted on GitHub.

Norman Finance MCP Server

This Model Context Protocol (MCP) server enables AI to interact with the Norman Finance API, allowing access to accounting, invoices, companies, clients, taxes, and more through a standardized protocol.

Note

The Norman Finance MCP Server is currently in Beta. We welcome your feedback and encourage you to report any bugs by opening an issue here.

Features

🔐 Authentication: Securely authenticate with the Norman Finance account
💼 Company Management: Manage your company details, get company balance, VAT insgihts, etc
📊 Accounting: Keep an eye on your transactions, categorization
📝 (e-)Invoicing: Make, view, send, and handle invoices. You can even set up recurring ones based on your contracts
👥 Client Management: Create and manage your clients (CRM)
💰 Taxes: View tax information and reports, generate official Finanzamt PDF previews and file your taxes
📄 Documents: Upload and manage attachments (receipts, invoices, docs, etc)

👇 Use case examples with Claude Desktop — toggle

Prerequisites

Before using this MCP server, you need to:

Create an account on Norman Finance
Have your email and password ready for authentication

Remote MCP Server

Norman now offers a hosted remote MCP server at:

https://mcp.norman.finance/sse

The remote MCP is recommended because it utilizes OAuth authentication, enabling you to log in directly with your Norman account without the need to create or manage access tokens manually.

Installation

Claude.ai Integrations

Adding the Norman MCP Server to Claude.ai:

For Claude Max:

Head to Settings > Profile
Find the "Integrations" section
Tap "Add more"
Enter the Norman MCP server URL: https://mcp.norman.finance/sse
Click "Add" to finish up

For Claude Enterprise & Teams:

Go to Settings > Integrations (for Teams) or Settings > Data management (for Enterprise)
Find the "Integrations" section
Hit "Add more"
Enter the Norman MCP server URL: https://mcp.norman.finance/sse
Click "Add" to finish up

Enabling the Norman Integration:

Start a chat with Claude.
Open the Search and tools menu.
Click "Connect" to link your Norman account.
After connecting, use the same menu to turn on specific Norman tools.

Adding to Claude Desktop

To run the Norman Finance MCP server with Claude Desktop, you can use the instruction above or add it manually using the following steps:

1. Download and Configure Claude Desktop

Download Claude Desktop.
Launch Claude and navigate to: Settings > Developer > Edit Config.
Update your claude_desktop_config.json file with the following configuration:

Remote MCP

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.norman.finance/sse"]
    }
  }
}

Local MCP

Install uv

Follow the instructions here: Installing uv

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "<home_path>/.local/bin/uvx",
      "args": [
        "--from",
        "norman-mcp-server@latest",
        "norman-mcp"
      ],
      "env": {
        "NORMAN_EMAIL": "your-email@example.com",
        "NORMAN_PASSWORD": "your-password",
        "NORMAN_ENVIRONMENT": "production"
      }
    }
  }
}

Configuration

Authentication Methods

The Norman MCP server supports two authentication methods:

1. OAuth Authentication (for SSE transport)

When using the server with MCP Inspector, Claude, or other SSE clients, the server uses OAuth 2.0 authentication:

Start the server with SSE transport:
python -m norman_mcp --transport sse
When connecting to the server, you'll be directed to a login page
Enter your Norman Finance credentials
You'll be redirected back to your application with authentication tokens

2. Environment Variables (for stdio transport)

When using the server with Claude Desktop or stdin/stdout communication, provide credentials through environment variables:

# .env
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # or "sandbox" for the development environment
NORMAN_API_TIMEOUT=200  # Request timeout in seconds

Environment Variables

The server can be configured using these environment variables:

# Authentication (for stdio transport)
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # or "sandbox" for the development environment

# Server configuration
NORMAN_MCP_HOST=0.0.0.0  # Host to bind to
NORMAN_MCP_PORT=3001     # Port to bind to
NORMAN_MCP_PUBLIC_URL=http://example.com  # Public URL for OAuth callbacks (important for remote access)
NORMAN_API_TIMEOUT=200   # Request timeout in seconds

Development

This section is for contributors who want to develop or extend the Norman Finance MCP server.

Local setup

git clone https://github.com/norman-finance/norman-mcp-server.git
cd norman-mcp-server
pip install -e .

Then update your claude_desktop_config.json file to point to the Python module directly:

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "<path_to_your_python>/python",
      "args": ["-m", "norman_mcp"],
      "env": {
        "NORMAN_EMAIL": "your-email@example.com",
        "NORMAN_PASSWORD": "your-password",
        "NORMAN_ENVIRONMENT": "production"
      }
    }
  }
}

Do you have a feature idea or something you'd like to see? Share your suggestion

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Norman Finance is an accounting and tax filing autopilot designed for entrepreneurs in Germany. The Norman Finance MCP server enables new ways of interacting with Norman Finance's accounting, tax, and invoicing services. Simplifying financial workflows by integrating Norman Finance API capabilities

Related MCP Servers

AlphaVantage-MCP
berlinbra
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
Last updated -
5
30
Python
MIT License
Ledger MCP Server
mprokopov
-
security
A
license
-
quality
An MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.
Last updated -
1
Python
GPL 3.0
Yahoo Finance MCP Server
narumiruna
A
security
A
license
A
quality
A simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.
Last updated -
10
9
Python
MIT License
mcp-mifosxofficial
openMF
-
security
F
license
-
quality
Integrate the MCP Server for Mifos X an Open Source Core Banking Solution for Financial Institutions. Useful for managing clients, loans, savings, shares, financial transactions and generating financial reports.
Last updated -
7

View all related MCP servers

Norman Finance MCP Server