Skip to content
Agentmart
Submit a tool

Popbill (세금계산서·알림톡)

Popbill MCP: Korean e-tax invoices (issue/cancel/search, Hometax sync) + KakaoTalk 알림톡.

Connector by groove79 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/groove79-mcp-popbill

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Popbill MCP: Korean e-tax invoices (issue/cancel/search, Hometax sync) + KakaoTalk 알림톡. 팝빌 MCP.

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
6 read · 3 write · 0 delete · 1 not yet classified
Secrets
2 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 10

Read from the source code; the running server may list different tools.

Read 6 · Look things up without changing anything.

  • popbill_check_account
  • popbill_get_alimtalk_result
  • popbill_get_taxinvoice
  • popbill_hometax_results
  • popbill_list_alimtalk_templates
  • popbill_search_taxinvoices

Write 3 · Create, change, send or run things.

  • popbill_cancel_taxinvoice
  • popbill_hometax_request
  • popbill_send_alimtalk

Not yet classified 1 · We could not tell from the name and description.

  • popbill_issue_taxinvoice

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • OKAGENT_API_KEY
  • POPBILL_SECRET_KEY

Other settings (environment variables or headers).

  • KMCP_WRITE_MODE
  • POPBILL_CORP_NUM
  • POPBILL_LINK_ID
  • POPBILL_TEST
  • POPBILL_USER_ID

Network hosts it talks to 4

  • appmonster.co.kr · found in code
  • developers.popbill.com · found in code
  • github.com · found in code
  • popbill.com · found in code

Tools (10)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • popbill_cancel_taxinvoice

    Cancel an issued e-tax invoice (발행취소) before it is transmitted to the NTS; after transmission a 수정세금계산서 is required instead. 발행완료 상태의 세금계산서를 발행취소합니다. Use when an invoice was issued by mistake and its state is 3xx (not yet 6xx). Needs keyType, mgtKey, and a memo.

  • popbill_check_account

    Check the Popbill connection: membership of the configured business number and remaining point balance. 팝빌 회원 여부와 포인트 잔액을 확인합니다. Use first, or when an issue/send fails. Needs nothing.

  • popbill_get_alimtalk_result

    Get delivery results for an 알림톡 send by receiptNum: per-recipient state, result code, send/receive times, fallback used. 알림톡 발송 결과를 조회합니다. Use a minute after popbill_send_alimtalk. Needs receiptNum.

  • popbill_get_taxinvoice

    Get one e-tax invoice in full (parties, line items, amounts, NTS confirmation number, state) plus a Popbill view URL. 세금계산서 1건의 상세를 조회합니다. Use after popbill_search_taxinvoices. Needs keyType and the mgtKey (문서번호).

  • popbill_hometax_request

    Start a Hometax (홈택스) collection job for e-tax invoices issued OUTSIDE Popbill too — sales or purchases in a date range (max 6 months). Returns a jobId; collection takes a few seconds to minutes. 홈택스에서 매출/매입 세금계산서를 수집하는 작업을 요청합니다. Use for bookkeeping, VAT prep (부가세 신고), or checking what suppliers billed you. Needs queryType SELL/BUY and dates (dateType W=작성일 I=발급일 S=전송일). Hometax 공동인증서 or 부서사용자 must be registered in Popbill.

  • popbill_hometax_results

    Read the results of a Hometax collection job: state (collecting / done / failed) and, when done, the collected invoices with parties, amounts, NTS numbers, paged. 홈택스 수집 작업 결과를 조회합니다. Use after popbill_hometax_request. Needs jobId; optional filters taxType (T/N/Z), purposeType (R 영수/C 청구/N 없음), query.

  • popbill_issue_taxinvoice

    Issue a sales e-tax invoice (정발행 세금계산서) in one step: saved + issued, emailed to the buyer, then reported to the NTS (국세청). Costs Popbill points. Totals are computed from the items. 매출 세금계산서를 즉시 발행합니다. Use when the sale is confirmed and the buyer's business number is verified. Needs the supplier (invoicer) and buyer (invoicee) parties, writeDate, and at least one item. Register the supplier's 공동인증서 in Popbill first.

  • popbill_list_alimtalk_templates

    List approved KakaoTalk 알림톡 templates (code, content with #{variables}, buttons) registered for this Popbill member. 승인된 알림톡 템플릿 목록을 조회합니다. Use before popbill_send_alimtalk to pick a templateCode and see its variables. Needs nothing.

  • popbill_search_taxinvoices

    Search e-tax invoices (전자세금계산서) issued through Popbill — sales (SELL) or purchases (BUY) — by date range, state, and free text. 팝빌에서 발행·수신한 세금계산서를 검색합니다. Use for '이번 달 발행한 세금계산서', unsent/failed NTS transmissions, or finding a mgtKey before cancelling. Needs keyType and dates; dateType W=작성일 R=등록일 I=발행일.

  • popbill_send_alimtalk

    Send KakaoTalk 알림톡 (official business notification) to up to 1,000 phone numbers using an approved template; falls back to SMS/LMS when the recipient can't receive it. Costs points per message. 승인된 템플릿으로 알림톡을 발송합니다. Use for order/shipping/approval notices to customers. Needs templateCode, the registered sender number, and recipients with the template text filled in (variables substituted — must match the template exactly).

Compare and alternatives

    Featured in

    Signals

    Stars
    0
    Forks
    0
    Open issues
    0
    Weekly downloads
    219
    Last commit (this folder)
    Oct 22, 2026 (6 days ago)
    Last release
    Oct 23, 2026 (5 days ago)
    Last package publish
    Oct 23, 2026 (5 days ago)

    From GitHub (fetched Oct 24, 2026) and the package registry.

    Details

    Registry name
    io.github.groove79/mcp-popbill
    Version
    0.2.0
    Auth
    API key
    License
    MIT
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026

    More from groove79

    Cite this page

    Popbill (세금계산서·알림톡) MCP server. Agent Mart. https://agentmart.dev/connectors/groove79-mcp-popbill (last updated 2026-10-24)