docnova-mcp

MCP server for e-invoice platforms. Connect Claude Code or Claude Desktop to your e-invoice account to query invoices, partners, company data, and financial reports with natural language.

Installation

No install needed — run directly via npx:

npx -y docnova-mcp

Configuration

Claude Code (~/.claude/settings.json or project .claude/settings.json)

{
  "mcpServers": {
    "einvoice": {
      "command": "npx",
      "args": ["-y", "docnova-mcp"],
      "env": {
        "DOCNOVA_API_KEY": "your-api-key"
      }
    }
  }
}

Or via CLI:

claude mcp add einvoice -- npx -y docnova-mcp

Claude Desktop (claude_desktop_config.json)

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "einvoice": {
      "command": "npx",
      "args": ["-y", "docnova-mcp"],
      "env": {
        "DOCNOVA_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |---|---|---| | DOCNOVA_API_KEY | ✅ | Your e-invoice platform API key |

Available Tools

Invoice

• invoice_search — Search invoices with filters (date, status, direction, partner name)
• invoice_get — Get full invoice details by UUID
• invoice_get_pdf — Get the PDF URL for an invoice
• invoice_summary — Invoice count and amount summary for a company
• invoice_create — Create and send a new invoice (UBLDto format)

Partner

• partner_search — Search partners by name
• partner_get — Get partner details by UUID
• partner_create — Create a new partner

Company

• company_get — Get company profile and info
• company_stats — Monthly invoice totals by currency

Financial Reports

• finance_overview — Income/expense/VAT overview totals for a date range
• finance_monthly_income_expense — Monthly income, expense, and net amounts by currency
• finance_ap_ar — Monthly accounts receivable and payable with net position
• finance_vat — Monthly VAT income, VAT expense, and net VAT
• finance_outstanding — Monthly invoiced vs paid vs outstanding receivables/payables

Expense Reports

• expense_overview — Total expense and VAT amounts by currency for a date range
• expense_monthly — Monthly expense amounts by currency
• expense_vat — Monthly VAT on expenses by currency

Development

git clone https://github.com/docnova-ai/docnova-mcp.git
cd docnova-mcp
npm install
npm run dev          # tsx watch mode
npm run inspect      # MCP Inspector UI
npm run build        # compile to dist/

Authentication

Your API key is exchanged for a short-lived JWT automatically — no manual token management needed. Get your API key from your platform's portal → Settings → ERP Management → API Keys.