loading…
Search for a command to run...
loading…
An MCP server that integrates with MoneyForward Cloud Invoice API v3 to automate the creation and management of quotes and invoices. It supports Japanese invoic
An MCP server that integrates with MoneyForward Cloud Invoice API v3 to automate the creation and management of quotes and invoices. It supports Japanese invoice system compliance, allowing users to handle partners, items, and billing through natural language.
MoneyForward クラウド請求書 API v3 を使用した MCP プラグイン。インボイス制度対応の見積書・請求書の作成を自動化します。
mf_auth_status - 認証状態の確認mf_auth_start - OAuth認証の開始mf_auth_callback - 認証コードでトークン取得mf_refresh_token - トークンのリフレッシュmf_list_partners - 取引先一覧の取得mf_get_partner - 取引先詳細の取得mf_list_items - 品目一覧の取得mf_get_item - 品目詳細の取得mf_list_quotes - 見積書一覧の取得mf_get_quote - 見積書詳細の取得mf_create_quote - 見積書の作成（インボイス対応）mf_update_quote - 見積書の更新mf_download_quote_pdf - 見積書PDFのURL取得mf_convert_quote_to_billing - 見積書を請求書に変換⚠️ 注意: v3 APIでは納品書作成エンドポイントが提供されていません。納品書が必要な場合はマネーフォワードのWebUIで作成してください。
mf_list_billings - 請求書一覧の取得mf_get_billing - 請求書詳細の取得mf_create_billing - 請求書の作成（インボイス対応）mf_create_billing_from_quote - 見積書から請求書を作成mf_update_billing - 請求書の更新mf_update_payment_status - 入金状態の更新mf_download_billing_pdf - 請求書PDFのURL取得本MCPはインボイス制度（適格請求書等保存方式）に対応しています。
請求書・見積書作成時に明細行ごとに消費税区分を指定します。
| 値 | 説明 |
|---|---|
ten_percent |
10% |
eight_percent_as_reduced_tax_rate |
軽減税率8% |
eight_percent |
8% |
untaxable |
対象外 |
non_taxable |
非課税 |
インボイス対応請求書の作成には取引先のdepartment_idが必要です。本MCPではmf_create_billing・mf_create_quote実行時に自動で取引先の部門情報を取得します。
http://localhost:38080/callback）client_secret_post に設定（重要）⚠️ 注意: クライアント認証方式はデフォルトで
client_secret_basicになっていますが、本MCPではclient_secret_post方式を使用しています。アプリケーション作成時に必ず変更してください。
export MF_CLIENT_ID="your_client_id"
export MF_CLIENT_SECRET="your_client_secret"
export MF_CALLBACK_PORT="38080" # オプション（デフォルト: 38080）
重要: MoneyForwardのAPIアプリケーション設定で、リダイレクトURIに http://localhost:38080/callback を登録してください。
npm install
npm run build
~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加:
{
"mcpServers": {
"mf-invoice": {
"command": "npx",
"args": ["@tera911/mf-invoice-mcp"],
"env": {
"MF_CLIENT_ID": "your_client_id",
"MF_CLIENT_SECRET": "your_client_secret",
"MF_CALLBACK_PORT": "38080"
}
}
}
}
{
"mcpServers": {
"mf-invoice": {
"command": "node",
"args": ["/path/to/mf-invoice-mcp/dist/index.js"],
"env": {
"MF_CLIENT_ID": "your_client_id",
"MF_CLIENT_SECRET": "your_client_secret",
"MF_CALLBACK_PORT": "38080"
}
}
}
}
mf_auth_start を実行注意: 認証時はポート38080（またはMF_CALLBACK_PORTで指定したポート）が空いている必要があります。
User: A社への見積書を作成して
Claude: まず取引先を検索します。
[mf_list_partners で検索]
User: 見つかった。作成して。
Claude: [mf_create_quote で作成]
見積書を作成しました。
User: これで承認されたから請求書を作って
Claude: [mf_convert_quote_to_billing で変換]
見積書から請求書を作成しました。
User: B社への見積書を作成して、承認されたら納品書と請求書も作って
Claude: [mf_create_quote で作成]
見積書を作成しました。
User: 承認された
Claude: [mf_convert_quote_to_billing で請求書作成]
請求書を作成しました。
⚠️ 納品書はv3 APIでは作成できません。
マネーフォワードのWebUIから作成してください。
User: 先月B社に送った請求書と同じ内容で今月分を作成して
Claude: [mf_list_billings でB社の請求書を検索]
前月の請求書が見つかりました。同じ内容で作成しますか？
※インボイス対応のため消費税10%を適用します
User: はい
Claude: [mf_create_billing で作成（excise: ten_percent指定）]
請求書を作成しました。
/delivery_slips/from_quoteエンドポイントが提供されていません。納品書が必要な場合はWebUIで作成してください。/invoice_template_billingsエンドポイントを使用します（旧/billingsへのPOSTは404エラー）。認証情報は ~/.config/mf-invoice-mcp/tokens.json に保存されます。
MIT
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"mf-invoice-mcp": {
"command": "npx",
"args": []
}
}
}