Mcp Server
This is the official GooodBilling MCP server for managing Japanese invoices and quotes through conversational AI. It exposes 16 tools across customers, invoices, quotes, and sales reporting. You can search customers, create invoice drafts with line items and tax rates, update them iteratively, then send them via email with idempotency protection. The same flow works for quotes. It includes unpaid invoice tracking and sales summaries by date range. Authentication uses API tokens with granular scopes, and the server auto-fills tax rates from customer or tenant defaults to avoid hallucination. Draft operations are separate from sending, so you can review PDFs before emails go out. Useful if you're building AI-first billing workflows for Japanese businesses that need proper invoice formatting and tax compliance.
- tools
- 16
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Jun 7, 2026
Tools
16 toolsPublic tool metadata for what this MCP can expose to an agent.
search_customers取引先を検索 (名前・カナ・メール・登録番号)
取引先を検索 (名前・カナ・メール・登録番号)
No parameter schema in public metadata yet.
list_invoices請求書一覧 (status / customer / 期間フィルタ)
請求書一覧 (status / customer / 期間フィルタ)
No parameter schema in public metadata yet.
list_unpaid_invoices未入金請求書一覧 (overdue 限定可)
未入金請求書一覧 (overdue 限定可)
No parameter schema in public metadata yet.
get_invoice請求書 1 件詳細
請求書 1 件詳細
No parameter schema in public metadata yet.
create_invoice_draft請求書ドラフト作成 (必ず `draft` 状態)
請求書ドラフト作成 (必ず `draft` 状態)
No parameter schema in public metadata yet.
update_invoice_draftドラフト部分更新 (items 配列全置換)
ドラフト部分更新 (items 配列全置換)
No parameter schema in public metadata yet.
discard_invoice_draftドラフト破棄 (draft 状態のみ)
ドラフト破棄 (draft 状態のみ)
No parameter schema in public metadata yet.
send_invoice取引先へメール送付 (idempotency-key 自動付与)
取引先へメール送付 (idempotency-key 自動付与)
No parameter schema in public metadata yet.
list_quotes見積一覧
見積一覧
No parameter schema in public metadata yet.
get_quote見積 1 件詳細
見積 1 件詳細
No parameter schema in public metadata yet.
create_quote_draft見積ドラフト作成
見積ドラフト作成
No parameter schema in public metadata yet.
update_quote_draftドラフト部分更新
ドラフト部分更新
No parameter schema in public metadata yet.
discard_quote_draftドラフト破棄
ドラフト破棄
No parameter schema in public metadata yet.
send_quote取引先へメール送付
取引先へメール送付
No parameter schema in public metadata yet.
get_sales_summary期間集計 (請求金額・入金額・未入金額)
期間集計 (請求金額・入金額・未入金額)
No parameter schema in public metadata yet.
get_tenant_settings送信機能 ON/OFF、BCC 自動付与、既定税率の確認 (read-only)
送信機能 ON/OFF、BCC 自動付与、既定税率の確認 (read-only)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GOOODBILLING_API_TOKEN*secretGooodBilling API トークン (gb_live_...)。https://gooodbilling.com/settings/api-tokens で発行
GOOODBILLING_API_BASE_URLAPI ベースURL。任意。既定は https://gooodbilling.com
Readme
@gooodbilling/mcp-server
GooodBilling 公式 MCP Server。Claude Desktop / Cursor 等の MCP 対応クライアントから、AI ファーストで請求書・見積書を操作できます。
「A 社向け Web 制作 30 万円で請求書作って」「保守費 10 万円も追加して」「これで送信して」— PC を開かず、チャットだけで業務を完結できます。
動作要件
- Node.js 18 以上
- GooodBilling アカウントと API トークン (発行手順は下記)
API トークンの発行
- GooodBilling にログイン
設定 > AI 連携 > API トークンを開く- 「新しいトークンを発行」をクリック
- 用途別テンプレートから選択 (Claude Desktop 推奨スコープを選ぶと簡単)
- 表示された平文トークン (
gb_live_...) を 1 度だけコピー
⚠️ トークンは発行時に 1 度だけしか表示されません。必ずすぐに MCP クライアントの設定に登録してください。
Claude Desktop での設定
1. 設定ファイルを開く
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
2. mcpServers セクションに以下を追加
Details
- Repository
- github.com/gooodbilling/mcp-server
- Package
@gooodbilling/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active