Skip to content
MCP server

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

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.0
Listing updated
5 days ago

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

Popbill (세금계산서·알림톡) is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add mcp-popbill --env POPBILL_LINK_ID='<POPBILL_LINK_ID>' --env POPBILL_SECRET_KEY='<POPBILL_SECRET_KEY>' --env POPBILL_CORP_NUM='<POPBILL_CORP_NUM>' --env OKAGENT_API_KEY='<OKAGENT_API_KEY>' -- npx -y @appmonster/mcp-popbill

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-popbill": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "<POPBILL_LINK_ID>",
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>",
        "POPBILL_CORP_NUM": "<POPBILL_CORP_NUM>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-popbill": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "<POPBILL_LINK_ID>",
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>",
        "POPBILL_CORP_NUM": "<POPBILL_CORP_NUM>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-popbill": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "<POPBILL_LINK_ID>",
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>",
        "POPBILL_CORP_NUM": "<POPBILL_CORP_NUM>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-popbill": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "<POPBILL_LINK_ID>",
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>",
        "POPBILL_CORP_NUM": "<POPBILL_CORP_NUM>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-popbill": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "<POPBILL_LINK_ID>",
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>",
        "POPBILL_CORP_NUM": "<POPBILL_CORP_NUM>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • POPBILL_LINK_IDPopbill API link id (developers.popbill.com)Required
  • POPBILL_SECRET_KEYPopbill API secret keyRequired
  • POPBILL_CORP_NUMMember business number (10 digits)Required
  • POPBILL_USER_IDPopbill member user id
  • POPBILL_TESTtrue = test server (default true)
  • OKAGENT_API_KEYOK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.
  • KMCP_WRITE_MODEapproval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

Pricing

Open source

Prices change. Check appmonster.co.kr before you buy.

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

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

Yes. Popbill (세금계산서·알림톡) is open source, so you can use and self-host it for free.

How do I add Popbill (세금계산서·알림톡) to Claude Code?

Run this command in your terminal: claude mcp add mcp-popbill --env POPBILL_LINK_ID='<POPBILL_LINK_ID>' --env POPBILL_SECRET_KEY='<POPBILL_SECRET_KEY>' --env POPBILL_CORP_NUM='<POPBILL_CORP_NUM>' --env OKAGENT_API_KEY='<OKAGENT_API_KEY>' -- npx -y @appmonster/mcp-popbill

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers