Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MF Invoice MCP先月の株式会社サンプル宛の請求書と同じ内容で今月分を作成して"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MF Invoice MCP
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はインボイス制度（適格請求書等保存方式）に対応しています。
消費税区分（excise）
請求書・見積書作成時に明細行ごとに消費税区分を指定します。
値 | 説明 |
| 10% |
| 軽減税率8% |
| 8% |
| 対象外 |
| 非課税 |
department_id
インボイス対応請求書の作成には取引先のdepartment_idが必要です。本MCPではmf_create_billing・mf_create_quote実行時に自動で取引先の部門情報を取得します。
セットアップ
1. MoneyForward クラウドでAPIアプリケーションを作成
MoneyForward クラウドにログイン
開発者設定からAPIアプリケーションを作成
Client ID と Client Secret を取得
リダイレクトURIを設定（例:
http://localhost:38080/callback）クライアント認証方式を （重要）
⚠️ 注意: クライアント認証方式はデフォルトで
client_secret_basicになっていますが、本MCPではclient_secret_post方式を使用しています。アプリケーション作成時に必ず変更してください。
2. 環境変数の設定
重要: MoneyForwardのAPIアプリケーション設定で、リダイレクトURIに http://localhost:38080/callback を登録してください。
3. ビルド
4. Claude Desktop への設定
~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加:
npx を使用する場合（推奨）
ローカルビルドを使用する場合
5. 初回認証
Claude で
mf_auth_startを実行表示されたURLをブラウザで開く
MoneyForward にログインして認可
認証完了後、自動的にトークンが保存される
注意: 認証時はポート38080（またはMF_CALLBACK_PORTで指定したポート）が空いている必要があります。
使用例
見積書を作成して請求書に変換
見積書・納品書・請求書の3点セット
過去の請求書を参照して新規作成（インボイス対応）
API制限
レート制限: 1秒あたり3リクエストまで（自動で制御）
超過時は HTTP 429 が返され、自動でリトライ
v3 API 制限事項
納品書作成: v3 APIでは
/delivery_slips/from_quoteエンドポイントが提供されていません。納品書が必要な場合はWebUIで作成してください。請求書作成: インボイス対応の請求書作成には
/invoice_template_billingsエンドポイントを使用します（旧/billingsへのPOSTは404エラー）。
トークン保存場所
認証情報は ~/.config/mf-invoice-mcp/tokens.json に保存されます。
ライセンス
MIT