프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 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 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.

내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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이 목록에 있고 연결됨으로 보이면 돼요

  5. 해 보기

    Invoice Generator Freelancers을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ VS Code가 Invoice Generator Freelancers을 쓰고 있다고 하거나 답에 Invoice Generator Freelancers 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

웹으로 연결하는 앱용 주소

주소https://mcp.zovo.one/mcp/invoice-generator-freelancers

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Invoice Generator Freelancers을 쓰는 사람에게 물어보세요💬 토론 →
개발자용: 터미널 명령과 JSON 설정

웹으로 연결

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 항목이 여러 개 있어 별은 순위에서 한 번만 세요
주간 다운로드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 사용

  • ✓ 통과

    엔드포인트 응답

    1111ms 만에 응답(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

  • 이 카테고리의 다른 서버 3407개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 3407개 중 36%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 3407개 중 99%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Invoice Generator Freelancers, 안전한가요?

해당하는 기본 점검 5개 중 5개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: Authorization

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 어제 변경됐고, 최신 버전(0.23.2)은 2개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 받는 앱에서도 쓸 수 있어요. 예: 웹 ChatGPT(Business 이상은 전체 MCP, Pro는 읽기 전용).

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도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

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요