プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Invoice Generator Freelancers

作者:theluckystrikeバージョン 0.23.2i★ 2 (リポジトリ全体のスター)iクラウドで動く公式サイト ↗
レジストリ名io.github.theluckystrike/invoice-generator-freelancers

インストール方法

What it does

Freelancer invoice generator: line items, tax, totals, PDF - issued from a chat message.

  • Connects クラウドで動く
  • Account or key Needs Authorization
  • Category 会計・財務・税務

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Invoice Generator Freelancers をインストールして。https://mcp.popnx.com/i/theluckystrike-invoice-generator-freelancers.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp.zovo.one)を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Invoice Generator Freelancers に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Invoice Generator Freelancers のサイトを開く ↗

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Invoice Generator Freelancers
    Remote MCP server URL · アドレスhttps://mcp.zovo.one/mcp/invoice-generator-freelancers

    Request headers に、この名前と値を追加

    ヘッダー名Authorization
    値Bearer <ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsInvoice Generator Freelancers

  5. 試してみる

    Invoice Generator Freelancers を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Invoice Generator Freelancers を使っていると言うか、回答に Invoice Generator Freelancers のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Invoice Generator Freelancers につなげません

Invoice Generator Freelancers は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · Invoice Generator Freelancers につなげるアプリを使う

  • Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成)
  • Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成)
  • Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成)

B · 会計・財務・税務 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成)

  1. Invoice Generator Freelancers に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Invoice Generator Freelancers のサイトを開く ↗

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user invoice-generator-freelancers https://mcp.zovo.one/mcp/invoice-generator-freelancers --header 'Authorization: Bearer your-value'

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    Invoice Generator Freelancers が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Invoice Generator Freelancers を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Invoice Generator Freelancers を使っていると言うか、回答に Invoice Generator Freelancers のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成)

  1. Invoice Generator Freelancers に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Invoice Generator Freelancers のサイトを開く ↗

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    Invoice Generator Freelancers の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    Invoice Generator Freelancers を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Invoice Generator Freelancers を使っていると言うか、回答に Invoice Generator Freelancers のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

Invoice Generator Freelancers のキーが必要です(提供元のサイトで作成)

  1. Invoice Generator Freelancers に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Invoice Generator Freelancers のサイトを開く ↗

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    Invoice Generator Freelancers の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    Invoice Generator Freelancers を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Invoice Generator Freelancers を使っていると言うか、回答に Invoice Generator Freelancers のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.zovo.one/mcp/invoice-generator-freelancers

JSON 設定は下の「開発者向け」にあります

つまずいたら?Invoice Generator Freelancers を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user invoice-generator-freelancers https://mcp.zovo.one/mcp/invoice-generator-freelancers --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "invoice-generator-freelancers": {
      "url": "https://mcp.zovo.one/mcp/invoice-generator-freelancers",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "invoice-generator-freelancers": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/invoice-generator-freelancers",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

自分で入力する値

  • Authorization 秘密 必須 HTTP header
    Bearer

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

GitHubスターi
2 (リポジトリ全体のスター)
このリポジトリには複数の MCP があり、スターは順位で1件だけ数えます
週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
0.23.2
レジストリ公開日i
2026年9月26日
コードの最終更新i
2026年11月18日
最終確認
2026年11月14日
作者
theluckystrike
ウェブサイト
mcp.zovo.one
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月14日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • business_set

    The ONE business profile for the whole suite: name, address, VAT id, bank details and defaults (currency, tax rate, terms, prefix, timezone). Saved to the shared profile every other server reads. Call it once, first.

  • client_add

    Store a client so invoice_create can refer to them by name. Re-adding the same name updates the stored address, email and VAT id; a record identical to a stored one is refused, naming the id that already holds it.

  • client_delete

    Delete one stored client that nothing refers to. A client named on any invoice, quote, credit note, purchase order, deposit, statement or schedule is refused with those documents listed.

  • client_list

    List every stored client with id, address, email and VAT id. No arguments, and it writes nothing. With none stored it says so: invoice_create also creates a client from the name you pass.

  • invoice_create

    Create an invoice from line items and return the record with its next, never-reused number. unit_price is in MAJOR units; lines are rounded then summed. One currency per invoice. Free: 3 a month.

  • invoice_from_hours

    Shortcut for the common case: bill one client for N hours at an hourly rate. Creates and returns a single-line invoice, converting the rate into target_currency when you supply fx_rates, and echoing back any entry_ids.

  • invoice_list

    List invoices by number: client, dates, currency, subtotal, discount, tax lines, total, status, paid, credited and the balance still due after any credit note. Filter by status, client and date range.

  • invoice_get

    Return the full stored record for one invoice number, including every line, tax breakdown, and the balance still open after any credit note issued against it (see credited_minor).

  • invoice_mark_paid

    Record a payment on one invoice. amount is in MAJOR units and ADDS to what is paid, never replaces it; omit it to settle the rest. An overpayment is refused, naming the open balance.

  • invoice_pdf

    Call this tool to write one stored invoice as an A4 PDF and return the path: issuer, BILL TO, dates, items, taxes and totals. Free stamps a credit line and no logo; Pro renders it unbranded with your logo.

  • overdue_report

    List every invoice not paid in full whose due date has passed, worst first, with days overdue and the amount, then a total per currency. Free. Use invoice_list for everything still open.

  • license_status

    Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

  • license_activate

    Turn Pro on for this connection with key, an MCPL1. . issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント theluckystrike で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    1111ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    13件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/theluckystrike-invoice-generator-freelancers.svg)](https://mcp.popnx.com/en/servers/theluckystrike-invoice-generator-freelancers)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

会計・財務・税務のほかのサーバーとの比較i

  • このカテゴリのほかの3417件のうち0%よりスターが多い
  • このカテゴリのほかの3417件のうち35%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3417件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Invoice Generator Freelancersは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:Authorization

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.23.2)がレジストリに届いたのは2 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

作者:SolidInvoice成長中★ 98910 日前更新

クラウドで動く✓ 提供元 · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

作者:signal8ai成長中↓ 431/週★ 42510 日前更新

パソコンでもクラウドでも✓ 提供元 · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

作者:Cursivez成長中★ 26111 日前更新

クラウドで動く✓ 提供元 · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

作者:bex-co成長中★ 688 リポジトリ全体のスター44 日前更新

クラウドで動く✓ 提供元 · beancount.io
似たものと比べる
これ
Invoice Generator Freelancers
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使える
キーが必要はいいいえはいいいえいいえはい
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/65/54/44/45/5
ライセンスMITMITMITNOASSERTIONMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Generate & send invoices from Claude with a free MCP server

Listed on the [AI Product Index](https://index.percall.dev/l/zovo-invoice.html) - live remote endpoint at mcp.zovo.one/s/invoice, free tier, no signup.

Featured on [Awesome MCP Servers](https://mcpservers.org) - directory listing | live hosted endpoint, free tier, no signup.

Say "make an invoice for Acme, 12 hours at 90 EUR, due in 14 days" and get a real PDF you can send. This MCP server stores your business profile and your clients, allocates a sequential invoice number that is never reused, computes the subtotal, any discount, one tax line per VAT rate and the total in integer minor units, and renders an A4 PDF with your issuer and payment details, a wrapping item table and a proper totals block. It also tracks payments and, on Pro, reports what is overdue and by how many days. Everything is stored in plain JSON files on your own machine; nothing is uploaded anywhere.

In the official MCP Registry (io.github.theluckystrike/invoice-pdf-billing-generator).

Create numbered invoices with tax lines and a real PDF from chat, no invoicing SaaS required.

60-second install

npm publish for @theluckystrike/mcp-invoice is pending. Until then, the .mcpb one-click bundle or a clone+build is the working path, both are verified below.

One-click (.mcpb): download invoice.mcpb from the latest release and double-click it in Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

(claude_desktop_config.json):

{

"mcpServers": { "invoice": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-invoice"] } } }

Claude Code:

claude mcp add invoice -- npx -y @theluckystrike/mcp-invoice

(.cursor/mcp.json):

{

"mcpServers": { "invoice": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-invoice"] } } }

The npx form above starts working the moment the package is published. Until then, use the .mcpb bundle above, or build from source with exactly these three commands:

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers

npm install npm run build -w packages/mcp-license -w servers/invoice

Then point your client's command at node with one arg: the absolute path to servers/invoice/dist/index.js.

To run in Pro mode set MCP_LICENSE_KEY in the same config block, or call license_activate once with your key.

Tools

ToolWhat it does
business_setStore the issuer profile: name, address, email, VAT id, IBAN, bank, logo, default currency, default tax rate, payment terms, invoice prefix. tax_rate, vat_rate and vat are accepted as aliases for default_tax_rate, and any unrecognised field is reported back rather than dropped
client_addAdd or update a client (name, address, email, VAT id). A record identical to one already stored is refused, naming the id that holds it, so the same client cannot be stored twice
client_deleteDelete a stored client nothing uses. Refused, with the document named, while an invoice, quote, credit note, purchase order, deposit, statement or recurring schedule still references it
client_listList stored clients with their ids
invoice_createCreate an invoice from line items; allocates the next number, computes discount, tax per rate and total. Items may carry a per-line currency, and a mix is refused rather than billed as one currency. If the client is created from a bare name the response says the BILL TO block has no address and how to add one
invoice_from_hoursShortcut: bill one client for N hours at an hourly rate. target_currency + fx_rates issue the invoice in another currency (you supply the rate); entry_ids come back with the new invoice number so the tracked hours can be closed with the time tracker's entry_mark_billed
invoice_listList invoices, filtered by status, client and issue-date range
invoice_getFull stored record for one invoice number
invoice_mark_paidRecord a payment in full or in part; reports the balance due
invoice_pdfRender the A4 PDF and return the file path. The response calls the file a PDF only when it is one
overdue_reportUnpaid invoices past due, days overdue, outstanding totals per currency. Free
license_statusShow free or Pro mode
license_activateActivate a Pro key (verified offline)

Resource: invoices://open returns every unpaid or partly paid invoice as JSON.

Prompt: monthly_invoicing reviews what is unpaid and what is overdue for a month, then drafts the next invoice.

What you can say

You sayTool
"Set up my business: Acme Consulting, EUR, 23% VAT, 14 day terms."business_set
"Add a client: Beta Corp, their VAT id is..., email billing@beta.example."client_add
"List my clients."client_list
"Remove that duplicate Beta Corp client."client_delete
"Invoice Acme for 12 hours at 90 EUR plus 300 EUR setup, 23% VAT, PDF."invoice_create + invoice_pdf
"Bill Beta Corp for 5 hours at 120 EUR."invoice_from_hours
"Show me every unpaid invoice from August."invoice_list
"Pull up invoice INV-2026-0007."invoice_get
"Mark INV-2026-0007 as paid in full."invoice_mark_paid
"Which invoices are unpaid and overdue?"overdue_report
"Am I on the free plan or Pro?"license_status

Worked example

From docs/USER_VALUE_R2.md, the exact request tested end to end and independently checked against the arithmetic.

You: Invoice Acme for 12 hours of API work at 90 EUR plus a 300 EUR setup fee,

23% VAT, due in 14 days, and give me the PDF.

invoice_create { client: "Acme", currency: "EUR", due_days: 14, items: [ { description: "API work", quantity: 12, unit_price: 90, tax_rate: 23 }, { description: "Setup fee", quantity: 1, unit_price: 300, tax_rate: 23 } ] } -> INV-2026-0001, client "Acme" created with no address on file

invoice_pdf { number: "INV-2026-0001" } -> /Users/you/.../invoice/pdf/INV-2026-0001.pdf

Assistant: Created INV-2026-0001 for Acme. API work 12 h x EUR 90.00 = EUR 1080.00 Setup fee 1 x EUR 300.00 = EUR 300.00 Subtotal EUR 1380.00 Tax 23% on EUR 1380.00 EUR 317.40 Total EUR 1697.40 Note: Acme was created from a bare name with no address. Add one with client_add before you send this. PDF: INV-2026-0001.pdf

The arithmetic: 12 x 90 = 1080.00, plus 300.00 = 1380.00 subtotal; 23% of 1380.00 = 317.40; total 1697.40 EUR. Every amount on the PDF and in the text response carries its currency code, nothing is ever shown as a bare number.

Free vs Pro

FreePro
Invoices3 per calendar monthUnlimited
overdue_reportYes, unlimitedYes, unlimited
PDFCarries the line "Generated with mcp-invoice by theluckystrike"No branding
Logo on the PDFNoYes
Custom invoice prefixNo, fixed INVYes
Clients, tax lines, discounts, payments, multi-currencyYesYes

Pro is a one-time $19, or $39 for every server in the collection, lifetime.

Numbers and money

Invoice numbers are PREFIX-YYYY-NNNN. The counter is persisted per prefix and year and is written before the invoice is stored, so a crash burns a number rather than reusing one; existing numbers are also scanned so a restored data file can never hand back a number that is already on a sent document.

Every money value printed anywhere - line unit prices, line amounts, subtotal, discount, each tax line, the total and the balance due, in the text response and on the PDF - carries its currency code, for example EUR 1080.00. No amount is ever shown as a bare number.

All amounts are held as integer minor units. How many make one unit comes from an ISO 4217 table, not a guess: 2 for most currencies, 0 for JPY, KRW, VND, CLP, ISK and the rest of the zero-decimal list, 3 for BHD, IQD, JOD, KWD, LYD, OMR and TND, 4 for CLF and UYW. KWD 1.234 is 1234 minor units, not 123. The table is identical to the one in mcp-expense-tracker, because the two servers exchange amounts and a currency that is 3-decimal in one and 2-decimal in the other would rescale money by ten. HUF is 2 decimals: ISO 4217 gives it two minor digits even though it is usually quoted without them. Rounding is per line, then summed: each line's gross is rounded first, an invoice-level discount_percent is applied and rounded per line, tax is computed and rounded per line and then grouped into one line per rate, and the totals are plain integer sums of those already-rounded values. A printed total can therefore never disagree with the printed lines. Dates are ISO YYYY-MM-DD.

How it stores data

Business profile, clients, invoices and the number counter live under ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/invoice/ as separate JSON files, plus a pdf/ subfolder holding the rendered PDFs. Every mutating call (business_set, client_add, invoice_create, invoice_from_hours, invoice_mark_paid) runs inside locked(), which takes an advisory lock file at .../invoice/.lock for the duration of the call, this is what makes number allocation safe when two invoices are created in the same second, since the counter read, increment and invoice write all happen under one lock. Saves go to a temporary file and are renamed into place. To back up your invoicing data, copy the whole invoice/ data directory, including pdf/ if you want the rendered files too, they can always be regenerated from the stored records with invoice_pdf.

If one of those JSON files is unreadable or not valid JSON, it is never treated as "empty". The file is moved aside byte-for-byte as .json.corrupt- , a .json.corrupt marker is written, and every tool returns data file is corrupt; moved to ...; nothing was written until you restore a good copy and delete the marker. A truncated clients.json can no longer be silently replaced by an empty client list.

Limits and honest caveats

  • Free tier allows 3 invoices per calendar month; the counter resets on the 1st. overdue_report and everything else (clients, tax lines, discounts, payments, multi-currency) is unrestricted on free.
  • Clients are never metered: the client list is unlimited on free and on Pro. client_add still refuses a record identical to a stored one, and client_delete removes an unused client, so a mistyped or duplicated record can always be undone without a licence key. A client any document references cannot be deleted.
  • Free PDFs carry a small "Generated with mcp-invoice" footer line; Pro removes it and adds a logo.
  • Creating an invoice for a client name the server has never seen creates that client with no address; the response says so and names client_add as the fix, but nothing blocks you from sending a PDF with a bare-name BILL TO block if you ignore the note.
  • This server skips email-sending, payment-link and accounting-software sync: it produces the PDF and the record; getting it to the client is up to you.
  • Currency conversion is not performed anywhere, an invoice's currency is fixed at creation and every line must use amounts already in that currency.

Troubleshooting

  • `npx` hangs or fails to find the package: npm publish for this package is pending. Use the .mcpb bundle or the clone-and-build path above until it lands.
  • **Using the

冒頭だけを表示しています。続きはリポジトリで読めます