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 계정으로 안전하게 인증하세요

  • 💼 회사 관리 : 회사 세부 정보 관리, 회사 잔액, VAT 정보 등을 확인하세요.

  • 📊 회계 : 거래 내역, 분류를 확인하세요

  • 📝 (e-)송장 발행 : 송장을 작성, 확인, 발송 및 관리할 수 있습니다. 계약에 따라 정기 송장을 설정할 수도 있습니다.

  • 👥 고객 관리 : 고객 생성 및 관리(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 통합

Claude.ai에 Norman MCP 서버 추가:

클로드 맥스에게:

  1. 설정 > 프로필 로 이동하세요

  2. "통합" 섹션을 찾으세요

  3. "더 추가"를 탭하세요

  4. Norman MCP 서버 URL을 입력하세요: https://mcp.norman.finance/sse

  5. "추가"를 클릭하여 완료하세요.

Claude Enterprise 및 Teams의 경우:

  1. 설정 > 통합 (Teams의 경우) 또는 설정 > 데이터 관리 (Enterprise의 경우)로 이동합니다.

  2. "통합" 섹션을 찾으세요

  3. "더 추가"를 누르세요

  4. Norman MCP 서버 URL을 입력하세요: https://mcp.norman.finance/sse

  5. "추가"를 클릭하여 완료하세요.

노르만 통합을 가능하게 하다:

  1. 클로드와 채팅을 시작하세요.

  2. 검색 및 도구 메뉴를 엽니다.

  3. "연결"을 클릭하여 Norman 계정을 연결하세요.

  4. 연결 후 동일한 메뉴를 사용하여 특정 Norman 도구를 켭니다.

Claude Desktop에 추가

Claude Desktop으로 Norman Finance MCP 서버를 실행하려면 위의 지침을 사용하거나 다음 단계에 따라 수동으로 추가할 수 있습니다.

1. Claude Desktop 다운로드 및 구성

  1. Claude Desktop을 다운로드하세요.

  2. Claude를 실행하고 설정 > 개발자 > 구성 편집으로 이동합니다.

  3. 다음 구성으로 claude_desktop_config.json 파일을 업데이트하세요.

원격 MCP

지엑스피1

지역 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