Skip to main content
Glama
Norman Finance MCP Server

Norman Finance MCP Server

Official

Norman Finance MCP 服务器

该模型上下文协议 (MCP)服务器使 AI 能够与 Norman Finance API 交互,允许通过标准化协议访问会计、发票、公司、客户、税收等。

[!笔记]

Norman Finance MCP 服务器目前处于测试阶段。我们欢迎您的反馈,并鼓励您在此处提交问题报告。

特征

  • 🔐身份验证:使用 Norman Finance 帐户进行安全身份验证

  • 💼公司管理:管理您的公司详细信息,获取公司余额、增值税信息等

  • 📊会计:密切关注您的交易、分类

  • 📝 (电子)发票:制作、查看、发送和处理发票。您甚至可以根据合同设置定期发票

  • 👥客户管理:创建和管理您的客户(CRM)

  • 💰税务:查看税务信息和报告,生成官方 Finanzamt PDF 预览并申报税务

  • 📄文件:上传和管理附件(收据、发票、文件等)

👇 使用 Claude Desktop 的案例示例 — 切换

Related MCP server: einvoice-mcp

先决条件

使用此 MCP 服务器之前,您需要:

  1. 在Norman Finance上创建账户

  2. 准备好电子邮件和密码以进行身份验证

远程 MCP 服务器

Norman 现在提供托管远程 MCP 服务器:

https://mcp.norman.finance/sse

建议使用远程 MCP,因为它采用 OAuth 身份验证,使您能够直接使用 Norman 帐户登录,而无需手动创建或管理访问令牌。

安装

Claude.ai集成

将 Norman MCP 服务器添加到 Claude.ai:

对于克劳德·马克斯来说:

  1. 前往*“设置”>“个人资料”*

  2. 找到“集成”部分

  3. 点按“添加更多”

  4. 输入 Norman MCP 服务器 URL: https://mcp.norman.finance/sse

  5. 点击“添加”完成

对于 Claude 企业和团队:

  1. 转至*“设置”>“集成”* (针对团队)或*“设置”>“数据管理*”(针对企业)

  2. 找到“集成”部分

  3. 点击“添加更多”

  4. 输入 Norman MCP 服务器 URL: https://mcp.norman.finance/sse

  5. 点击“添加”完成

启用 Norman 集成:

  1. 开始与 Claude 聊天。

  2. 打开搜索和工具菜单。

  3. 单击“连接”以链接您的 Norman 帐户。

  4. 连接后,使用相同的菜单打开特定的 Norman 工具。

添加到 Claude 桌面

要使用 Claude Desktop 运行 Norman Finance MCP 服务器,您可以使用上述说明或按照以下步骤手动添加:

1.下载并配置Claude Desktop

  1. 下载Claude 桌面。

  2. 启动 Claude 并导航至:设置 > 开发者 > 编辑配置。

  3. 使用以下配置更新您的claude_desktop_config.json文件:

远程 MCP

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

本地 MCP

安装 uv

按照此处的说明操作:安装 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"
      }
    }
  }
}

配置

身份验证方法

Norman MCP 服务器支持两种身份验证方法:

1. OAuth 身份验证(用于 SSE 传输)

当将服务器与 MCP Inspector、Claude 或其他 SSE 客户端一起使用时,服务器使用 OAuth 2.0 身份验证:

  1. 使用 SSE 传输启动服务器:

    python -m norman_mcp --transport sse
  2. 连接到服务器后,您将被引导至登录页面

  3. 输入您的 Norman Finance 凭证

  4. 您将被重定向回您的应用程序并带有身份验证令牌

2. 环境变量(用于 stdio 传输)

当使用带有 Claude Desktop 或 stdin/stdout 通信的服务器时,请通过环境变量提供凭据:

# .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

环境变量

可以使用以下环境变量配置服务器:

# 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

发展

本节适用于想要开发或扩展 Norman Finance MCP 服务器的贡献者。

本地设置

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

然后更新您的 claude_desktop_config.json 文件以直接指向 Python 模块:

{
  "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"
      }
    }
  }
}

你有什么功能创意或希望看到的内容吗?分享你的建议


Available Tools

34 tools
categorize_transactionBInspect
Detect category for a transaction using AI.

Args:
    transaction_amount: Amount of the transaction
    transaction_description: Description of the transaction
    transaction_type: Type of transaction ("income" or "expense")
    
Returns:
    Suggested category information for the transaction

Inputs: transaction_amount (required), transaction_description (required), transaction_type (required).

create_attachmentBInspect
Create a new attachment.

Args:
    file_path: Path to file to upload
    transactions: List of transaction IDs to link
    attachment_type: Type of attachment (invoice, receipt)
    amount: Amount related to attachment
    amount_exchanged: Exchanged amount in different currency
    attachment_number: Unique number for attachment
    brand_name: Brand name associated with attachment
    currency: Currency of amount (default EUR)
    currency_exchanged: Exchanged currency (default EUR)
    description: Description of attachment
    supplier_country: Country of supplier (DE, INSIDE_EU, OUTSIDE_EU)
    value_date: Date of value
    vat_sum_amount: VAT sum amount
    vat_sum_amount_exchanged: Exchanged VAT sum amount
    vat_rate: VAT rate percentage
    sale_type: Type of sale
    additional_metadata: Additional metadata for attachment
    
Returns:
    Created attachment information

Inputs: file_path (required), additional_metadata, amount, amount_exchanged, +13 more.

create_clientBInspect
Create a new client.

Args:
    name: Client name or business name
    client_type: Type of client (defaults to "business"), Options: "business", "private"
    address: Client physical address
    zip_code: Client postal/zip code
    email: Client email address
    country: Client country code (e.g. "DE")
    vat_number: Client VAT number
    city: Client city
    phone: Client phone number
    
Returns:
    Newly created client record

Inputs: name (required), address, city, client_type, +5 more.

create_invoiceAInspect
Create a new invoice. Ask for additional information if needed, for example:
- If the client is not found, ask for the client details and create a new client if necessary.
- If pyament reminder should be sent, ask for the reminder settings.
- If the invoice type is GOODS, ask for the delivery date.
- If the invoice type is SERVICES, ask for the service start and end dates.
- If the invoice should be sent to the client, ask for the email data.

Args:
    client_id: ID of the client for the invoice
    items: List of invoice items, each containing name, quantity, rate, vatRate and total. 
           Example: [{"name": "Software Development", "quantity": 3, "rate": 30000, "vatRate": 19, "total": 1071}] // VAT rates might be 0, 7, 19. By default it's 19. Rate and total are in cents.
    invoice_number: Optional invoice number (will be auto-generated if not provided)
    issued: Issue date in YYYY-MM-DD format
    due_to: Due date in YYYY-MM-DD format
    currency: Invoice currency (EUR, USD), by default it's EUR
    payment_terms: Payment terms text
    notes: Additional notes
    language: Invoice language (en, de)
    invoice_type: Type of invoice (SERVICES, GOODS)
    is_vat_included: Whether prices include VAT
    bank_name: Name of the bank (gets from company details if exists)
    iban: IBAN for payments (gets from company details if exists)
    bic: BIC/SWIFT code (gets from company details if exists)
    create_qr: Whether to create payment QR code (only if BIC and IBAN provided)
    color_schema: Invoice style color (hex code)
    font: Invoice font (e.g. "Plus Jakarta Sans", "Inter")
    is_to_send: Whether to send invoice automatically to client
    mailing_data: Email data if is_to_send is True. Example: {
        "emailSubject": "Invoice No.{invoice_number} for {client_name}",
        "emailBody": "Dear {client_name},...",
        "customClientEmail": "client@example.com" // email to send the invoice to, if not provided, it will be sent to the client email address
    }
    settings_on_overdue: Configuration for overdue notifications. Example: {
        "isToAutosendNotification": true, // whether to send notification automatically
        "customEmailSubject": "Reminder: Invoice {invoice_number} is overdue", // custom email subject
        "customEmailBody": "Dear {client_name},...", // custom email body
        "notifyAfterDays": [1, 3], // days to notify after the due date
        "notifyInParticularDays": [] // days to notify in particular dates [2025-05-23", "2025-05-24"]
    }
    service_start_date: Service period start date (YYYY-MM-DD) by default it's today, should be provided if invoice_type is SERVICES
    service_end_date: Service period end date (YYYY-MM-DD) by default it's one month from today, should be provided if invoice_type is SERVICES
    delivery_date: Delivery date for goods (YYYY-MM-DD) by default it's today, should be provided if invoice_type is GOODS

Returns:
    Information about the created invoice and always include the generated invoice pdf url from reportUrl field

Inputs: client_id (required), items (required), bank_name, bic, +19 more.

create_recurring_invoiceAInspect
Create a recurring invoice that will automatically generate new invoices based on specified frequency.
Useful for contracts or services that bill on a regular basis.
Always ask for reccurring configuration, for example:
    - How often to generate invoices (weekly, monthly)
    - Number of units for frequency (e.g. 1 for monthly = every month, 2 = every 2 months)
    - Start date
    - End date
    - End invoice count (optional)
    
Ask for additional information if needed, for example:
    - If the client is not found, ask for the client details and create a new client if necessary.
    - If the invoice number is not provided, ask for it.
    - If the due date is not provided, ask for it.
    - If the payment terms are not provided, ask for it.
    - If the bank details are not provided, ask for it.

Args:
    client_id: ID of the client for the invoice
    items: List of invoice items, each containing name, quantity, rate, vatRate and total
    frequency_type: How often to generate invoices ("weekly", "monthly")
    frequency_unit: Number of units for frequency (e.g. 1 for monthly = every month, 2 = every 2 months)
    starts_from_date: Date to start generating invoices from (YYYY-MM-DD)
    ends_on_date: Optional end date for recurring invoices (YYYY-MM-DD). Either ends_on_date or ends_on_invoice_count should be provided.
    ends_on_invoice_count: Optional number of invoices to generate before stopping. Either ends_on_date or ends_on_invoice_count should be provided.
    invoice_number: Base invoice number (will be auto-generated if not provided)
    issued: Issue date in YYYY-MM-DD format
    due_to: Due date in YYYY-MM-DD format
    currency: Invoice currency (EUR, USD), by default it's EUR
    payment_terms: Payment terms text
    notes: Additional notes
    language: Invoice language (en, de)
    invoice_type: Type of invoice (SERVICES, GOODS)
    is_vat_included: Whether prices include VAT
    bank_name: Name of the bank
    iban: IBAN for payments
    bic: BIC/SWIFT code
    create_qr: Whether to create payment QR code
    color_schema: Invoice style color (hex code)
    font: Invoice font (e.g. "Plus Jakarta Sans", "Inter")
    is_to_send: Whether to send invoices automatically to client
    settings_on_overdue: Configuration for overdue notifications
    service_start_date: Service period start date (for SERVICES type)
    service_end_date: Service period end date (for SERVICES type)
    delivery_date: Delivery date (for GOODS type)

Returns:
    Information about the created recurring invoice setup and always include the generated invoice pdf url from reportUrl field

Inputs: client_id (required), frequency_type (required), frequency_unit (required), items (required), +23 more.

create_transactionBInspect
Create a new manual transaction.

Args:
    amount: Transaction amount (positive for income, negative for expense)
    description: Transaction description
    category: Transaction category
    date: Transaction date in YYYY-MM-DD format (defaults to today)
    vat_rate: VAT rate (0, 7, 19)
    sale_type: Sale type (GOODS, SERVICES)
    supplier_country: Country of the supplier (DE, INSIDE_EU, OUTSIDE_EU)
    cashflow_type: Cashflow type of the transaction (INCOME, EXPENSE)
    category_id: Category ID of the transaction (If not provided, the transaction will be categorized automatically using AI)
Returns:
    Information about the created transaction

Inputs: amount (required), cashflow_type (required), description (required), supplier_country (required), +4 more.

delete_clientCInspect
Delete a client.

Args:
    client_id: ID of the client to delete
    
Returns:
    Confirmation of deletion

Inputs: client_id (required).

generate_finanzamt_previewCInspect
Generate a test Finanzamt preview for a tax report.

Args:
    report_id: Public ID of the tax report
    
Returns:
    Generate a PDF preview of the tax report. 
    Always suggest to check the preview before sending it to the Finanzamt.
    Always include the path to the generated PDF file as a link to open the file from local file system.
    Get the report data from @get_tax_report and show line items and totals.
      You could add short summary based on the report data.
    Ask follow up question to file the tax report to the Finanzamt @submit_tax_report. Don't send the report to the Finanzamt without the user confirmation.

Inputs: report_id (required).

get_clientCInspect
Get detailed information about a specific client.

Args:
    client_id: ID of the client to retrieve
    
Returns:
    Detailed client information

Inputs: client_id (required).

get_company_balanceCInspect
Get the current balance of the company.

Returns:
    Company balance information

Inputs: no named parameters.

get_company_detailsBInspect

Get detailed information about the user's company.

Inputs: no named parameters.

get_company_tax_statisticsCInspect
Get tax statistics for the company.

Returns:
    Company tax statistics data

Inputs: no named parameters.

get_einvoice_xmlBInspect
Get the e-invoice XML for a specific invoice.

Args:
    invoice_id: ID of the invoice to get XML for
    
Returns:
    E-invoice XML data

Inputs: invoice_id (required).

get_invoiceCInspect
Get detailed information about a specific invoice.

Args:
    invoice_id: ID of the invoice to retrieve
    
Returns:
    Detailed invoice information

Inputs: invoice_id (required).

get_tax_reportBInspect
Retrieve a specific tax report.

Args:
    report_id: Public ID of the tax report to retrieve
    
Returns:
    Tax report details

Inputs: report_id (required).

get_vat_next_reportCInspect
Get the VAT amount for the next report period.

Returns:
    VAT next report amount data

Inputs: no named parameters.

list_attachmentsBInspect
Get list of attachments with optional filters.

Args:
    file_name: Filter by file name (case insensitive partial match)
    linked: Filter by whether attachment is linked to transactions
    attachment_type: Filter by attachment type (invoice, receipt, contract, other)
    description: Filter by description (case insensitive partial match)
    brand_name: Filter by brand name (case insensitive partial match)
    
Returns:
    List of attachments matching the filters

Inputs: attachment_type, brand_name, description, file_name, +1 more.

list_clientsBInspect
Get a list of all clients for the company.

Returns:
    List of clients with their details

Inputs: no named parameters.

list_invoicesBInspect
List invoices with optional filtering.

Args:
    status: Filter by invoice status (draft, pending, sent, paid, overdue, uncollectible)
    name: Filter by invoice (client) name
    from_date: Filter invoices created after this date (YYYY-MM-DD)
    to_date: Filter invoices created before this date (YYYY-MM-DD)
    limit: Maximum number of invoices to return (default 100)
    
Returns:
    List of invoices matching the criteria

Inputs: from_date, limit, name, status, +1 more.

list_tax_reportsBInspect

List all available tax reports.

Inputs: no named parameters.

list_tax_settingsBInspect
Get list of tax settings for the current company.

Returns:
    List of company tax settings

Inputs: no named parameters.

list_tax_statesBInspect
Get list of available tax states.

Returns:
    List of tax states

Inputs: no named parameters.

search_transactionsAInspect
Search for transactions matching specified criteria.

Args:
    description: Text to search for in transaction descriptions
    from_date: Start date in YYYY-MM-DD format
    to_date: End date in YYYY-MM-DD format
    min_amount: Minimum transaction amount
    max_amount: Maximum transaction amount
    category: Transaction category
    limit: Maximum number of results to return (default 100)
    no_invoice: Whether to exclude invoices
    no_receipt: Whether to exclude receipts
    status: Status of the transaction (UNVERIFIED, VERIFIED)
    cashflow_type: Cashflow type of the transaction (INCOME, EXPENSE)
Returns:
    List of matching transactions with sensitive data removed

Inputs: cashflow_type, category, description, from_date, +7 more.

send_invoiceBInspect
Send an invoice via email.

Args:
    invoice_id: ID of the invoice to send
    subject: Email subject line
    body: Email body content
    additional_emails: List of additional email addresses to send to
    is_send_to_company: Whether to send the copy to the company email (Owner)
    custom_client_email: Custom email address for the client (By default the email address of the client is used if it is set)
    
Returns:
    Response from the send invoice request

Inputs: body (required), invoice_id (required), subject (required), additional_emails, +2 more.

send_invoice_overdue_reminderBInspect
Send an overdue payment reminder for an invoice via email.

Args:
    invoice_id: ID of the invoice to send reminder for
    subject: Email subject line
    body: Email body content
    additional_emails: List of additional email addresses to send to
    is_send_to_company: Whether to send the copy to the company email (Owner)
    custom_client_email: Custom email address for the client (By default the email address of the client is used if it is set)
    
Returns:
    Response from the send overdue reminder request

Inputs: body (required), invoice_id (required), subject (required), additional_emails, +2 more.

submit_tax_reportBInspect
Submit a tax report to the Finanzamt.

Args:
    report_id: Public ID of the tax report to submit
    
Returns:
    Response from the submission request and a link to the tax report from reportFile to download.
    If response status is 403, it means a paid subscription is required to file the report.

Inputs: report_id (required).

update_clientBInspect
Update an existing client.

Args:
    client_id: ID of the client to update
    name: Updated client name
    client_type: Updated client type ("business" or "private")
    address: Updated client physical address
    zip_code: Updated client postal/zip code
    email: Updated client email address
    country: Updated client country code (e.g. "DE")
    vat_number: Updated client VAT number
    city: Updated client city
    phone: Updated client phone number
    
Returns:
    Updated client record

Inputs: client_id (required), address, city, client_type, +6 more.

update_company_detailsDInspect

Update company information.

Inputs: activity_start, address, city, country, +7 more.

update_tax_settingAInspect
Update a tax setting. Always generate a preview of the tax report @generate_finanzamt_preview before submitting it to the Finanzamt.

Args:
    setting_id: Public ID of the tax setting to update
    tax_type: Type of tax (e.g. "sales")
    vat_type: VAT type (e.g. "vat_subject")
    vat_percent: VAT percentage
    start_tax_report_date: Start date for tax reporting (YYYY-MM-DD)
    reporting_frequency: Frequency of reporting (e.g. "monthly")
    
Returns:
    Updated tax setting

Inputs: setting_id (required), reporting_frequency, start_tax_report_date, tax_type, +2 more.

update_transactionCInspect

Update an existing transaction.

Inputs: transaction_id (required), amount, cashflow_type, category, +6 more.

upload_bulk_attachmentsBInspect
Upload multiple file attachments in bulk.

Args:
    file_paths: List of paths to files to upload
    cashflow_type: Optional cashflow type for the transactions (INCOME or EXPENSE)
    
Returns:
    Response from the bulk upload request

Inputs: file_paths (required), cashflow_type.

validate_tax_numberCInspect
Validate a tax number for a specific region.

Args:
    tax_number: Tax number to validate
    region_code: Region code (e.g. "BE" for Belgium)
    
Returns:
    Validation result for the tax number

Inputs: region_code (required), tax_number (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 34 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between create_transaction and categorize_transaction, and between send_invoice and send_invoice_overdue_reminder, which could cause minor confusion. However, descriptions clarify their specific roles, and the majority of tools target unique resources or actions.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with a clear verb_noun structure, such as create_client, list_invoices, and update_transaction. This uniformity makes the tool set predictable and easy to navigate.

    Tool Count3/5

    With 34 tools, the count is borderline high for a finance server, potentially overwhelming for an agent. While the domain is broad (clients, invoices, transactions, taxes, attachments), some tools might be redundant or overly specialized, making the set feel heavy.

    Completeness5/5

    The tool set provides comprehensive coverage for financial management, including full CRUD operations for clients, invoices, transactions, and attachments, plus tax reporting, validation, and email functionalities. There are no obvious gaps, and tools support end-to-end workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      MCP server for DACH accounting automation. Connect AI assistants to sevDesk and Lexoffice — create invoices, manage contacts, handle bookings and vouchers for German-speaking businesses.
      15
      55 npm
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for German e-invoice compliance (XRechnung 3.0 & ZUGFeRD 2.x) enabling AI agents to validate, generate, parse, and check compliance of electronic invoices per EN 16931.
      6
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Spanish accounting for freelancers and SMEs, enabling AI agents to issue invoices, OCR expense PDFs, reconcile bank transactions, and prepare quarterly VAT (Modelo 303).
      23
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that reads and annotates Kontist business banking data, including balances, transactions, and tax reserves.
      7
      1
      Apache 2.0