Norman Finance MCP Server
OfficialNorman Finance MCP 服务器
该模型上下文协议 (MCP)服务器使 AI 能够与 Norman Finance API 交互,允许通过标准化协议访问会计、发票、公司、客户、税收等。
[!笔记]
Norman Finance MCP 服务器目前处于测试阶段。我们欢迎您的反馈,并鼓励您在此处提交问题报告。
特征
🔐身份验证:使用 Norman Finance 帐户进行安全身份验证
💼公司管理:管理您的公司详细信息,获取公司余额、增值税信息等
📊会计:密切关注您的交易、分类
📝 (电子)发票:制作、查看、发送和处理发票。您甚至可以根据合同设置定期发票
👥客户管理:创建和管理您的客户(CRM)
💰税务:查看税务信息和报告,生成官方 Finanzamt PDF 预览并申报税务
📄文件:上传和管理附件(收据、发票、文件等)
👇 使用 Claude Desktop 的案例示例 — 切换
Related MCP server: einvoice-mcp
先决条件
使用此 MCP 服务器之前,您需要:
在Norman Finance上创建账户
准备好电子邮件和密码以进行身份验证
远程 MCP 服务器
Norman 现在提供托管远程 MCP 服务器:
建议使用远程 MCP,因为它采用 OAuth 身份验证,使您能够直接使用 Norman 帐户登录,而无需手动创建或管理访问令牌。
安装
Claude.ai集成
将 Norman MCP 服务器添加到 Claude.ai:
对于克劳德·马克斯来说:
前往*“设置”>“个人资料”*
找到“集成”部分
点按“添加更多”
输入 Norman MCP 服务器 URL:
https://mcp.norman.finance/sse点击“添加”完成
对于 Claude 企业和团队:
转至*“设置”>“集成”* (针对团队)或*“设置”>“数据管理*”(针对企业)
找到“集成”部分
点击“添加更多”
输入 Norman MCP 服务器 URL:
https://mcp.norman.finance/sse点击“添加”完成
启用 Norman 集成:
开始与 Claude 聊天。
打开搜索和工具菜单。
单击“连接”以链接您的 Norman 帐户。
连接后,使用相同的菜单打开特定的 Norman 工具。
添加到 Claude 桌面
要使用 Claude Desktop 运行 Norman Finance MCP 服务器,您可以使用上述说明或按照以下步骤手动添加:
1.下载并配置Claude Desktop
下载Claude 桌面。
启动 Claude 并导航至:设置 > 开发者 > 编辑配置。
使用以下配置更新您的
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 身份验证:
使用 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