Norman Finance MCP Server
OfficialNorman 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 서버를 사용하기 전에 다음이 필요합니다.
Norman Finance 에 계정을 만드세요
인증을 위해 이메일과 비밀번호를 준비하세요
원격 MCP 서버
Norman은 이제 다음 위치에서 호스팅되는 원격 MCP 서버를 제공합니다.
원격 MCP는 OAuth 인증을 활용하므로 수동으로 액세스 토큰을 만들거나 관리할 필요 없이 Norman 계정으로 직접 로그인할 수 있으므로 권장됩니다.
설치
Claude.ai 통합
Claude.ai에 Norman MCP 서버 추가:
클로드 맥스에게:
설정 > 프로필 로 이동하세요
"통합" 섹션을 찾으세요
"더 추가"를 탭하세요
Norman MCP 서버 URL을 입력하세요:
https://mcp.norman.finance/sse"추가"를 클릭하여 완료하세요.
Claude Enterprise 및 Teams의 경우:
설정 > 통합 (Teams의 경우) 또는 설정 > 데이터 관리 (Enterprise의 경우)로 이동합니다.
"통합" 섹션을 찾으세요
"더 추가"를 누르세요
Norman MCP 서버 URL을 입력하세요:
https://mcp.norman.finance/sse"추가"를 클릭하여 완료하세요.
노르만 통합을 가능하게 하다:
클로드와 채팅을 시작하세요.
검색 및 도구 메뉴를 엽니다.
"연결"을 클릭하여 Norman 계정을 연결하세요.
연결 후 동일한 메뉴를 사용하여 특정 Norman 도구를 켭니다.
Claude Desktop에 추가
Claude Desktop으로 Norman Finance MCP 서버를 실행하려면 위의 지침을 사용하거나 다음 단계에 따라 수동으로 추가할 수 있습니다.
1. Claude Desktop 다운로드 및 구성
Claude Desktop을 다운로드하세요.
Claude를 실행하고 설정 > 개발자 > 구성 편집으로 이동합니다.
다음 구성으로
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 인증을 사용합니다.
SSE 전송으로 서버를 시작합니다.
python -m norman_mcp --transport sse서버에 연결하면 로그인 페이지로 이동됩니다.
Norman Finance 자격 증명을 입력하세요
인증 토큰을 사용하여 애플리케이션으로 다시 리디렉션됩니다.
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 toolscategorize_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.
link_attachment_transactionCInspect
Link a transaction to an attachment.
Args:
attachment_id: ID of the attachment
transaction_id: ID of the transaction to link
Returns:
Response from the link transaction request
Inputs: attachment_id (required), transaction_id (required).
link_transactionBInspect
Link a transaction to an invoice.
Args:
invoice_id: ID of the invoice
transaction_id: ID of the transaction to link
Returns:
Response from the link transaction request
Inputs: invoice_id (required), transaction_id (required).
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
Scored across 34 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
Headless API-first double-entry accounting & bookkeeping engine. 84 MCP tools over HTTP.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
MCP server for MOCO business software: time tracking, projects, budgets, and invoicing via API
Related MCP Servers
- FlicenseBqualityDmaintenanceMCP server for DACH accounting automation. Connect AI assistants to sevDesk and Lexoffice — create invoices, manage contacts, handle bookings and vouchers for German-speaking businesses.1555 npm-
- AlicenseAqualityDmaintenanceMCP 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.61MIT
- AlicenseAqualityCmaintenanceMCP 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).234MIT
- AlicenseAqualityDmaintenanceMCP server that reads and annotates Kontist business banking data, including balances, transactions, and tax reserves.71Apache 2.0