moneyforward-connector
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MF_REDIRECT_URI | No | Set to http://127.0.0.1:38080/callback for the automatic loopback callback flow. Unset means out-of-band mode. Only loopback hosts are accepted, and the port must match MF_CALLBACK_PORT. | |
| MF_CALLBACK_PORT | No | Port for the loopback OAuth callback server. Default is 38080. Must match the port in the redirect URI you registered. | 38080 |
| MF_EXPENSE_CLIENT_ID | No | Client ID for the MoneyForward Cloud Expense API. Required for expense tools. | |
| MF_INVOICE_CLIENT_ID | No | Client ID for the MoneyForward Cloud Invoice API. Required for invoice tools. MF_CLIENT_ID is also accepted as an alias. | |
| MF_ACCOUNTING_CLIENT_ID | No | Client ID for the MoneyForward Cloud Accounting API. Required for accounting tools. | |
| MF_EXPENSE_CLIENT_SECRET | No | Client secret for the MoneyForward Cloud Expense API. Required for expense tools. | |
| MF_INVOICE_CLIENT_SECRET | No | Client secret for the MoneyForward Cloud Invoice API. Required for invoice tools. MF_CLIENT_SECRET is also accepted as an alias. | |
| MF_ACCOUNTING_CLIENT_SECRET | No | Client secret for the MoneyForward Cloud Accounting API. Required for accounting tools. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mf_auth_statusC | 認証状態を確認します |
| mf_auth_startA | OAuth認証を開始します。デフォルトはOOBモード（認証コードが画面に表示される）。MF_REDIRECT_URIにlocalhost URLを設定するとコールバックサーバーモードになります。 |
| mf_auth_callbackB | 認証コードを使用してアクセストークンを取得します（OOBモードで認証後に使用） |
| mf_refresh_tokenB | アクセストークンをリフレッシュします |
| mf_list_partnersC | 取引先一覧を取得します。検索キーワードで絞り込み可能です。 |
| mf_get_partnerC | 取引先の詳細情報を取得します |
| mf_list_itemsC | 品目一覧を取得します。検索キーワードで絞り込み可能です。 |
| mf_get_itemC | 品目の詳細情報を取得します |
| mf_list_quotesB | 見積書一覧を取得します。取引先や期間で絞り込み可能です。 |
| mf_get_quoteC | 見積書の詳細情報を取得します |
| mf_create_quoteC | インボイス制度対応の見積書を作成します |
| mf_update_quoteC | 見積書を更新します |
| mf_download_quote_pdfC | 見積書のPDF URLを取得します |
| mf_convert_quote_to_billingC | 見積書を請求書に変換します |
| mf_list_billingsC | 請求書一覧を取得します。取引先や期間で絞り込み可能です。 |
| mf_get_billingC | 請求書の詳細情報を取得します |
| mf_create_billingC | インボイス制度対応の請求書を作成します |
| mf_create_billing_from_quoteC | 見積書から請求書を作成します |
| mf_update_billingA | 請求書を更新します。items を指定すると明細を全置換します（既存明細を削除してから追加するため、途中で失敗すると明細が欠けた状態になり得ます）。取引先の変更は API 非対応です。 |
| mf_delete_billingA | 請求書を削除します。元に戻せないため、実行前に必ずユーザーへ確認してください。 |
| mf_update_payment_statusC | 請求書の入金状態を更新します |
| mf_download_billing_pdfC | 請求書のPDF URLを取得します |
| mf_create_delivery_slipA | 【v3 API未サポート】見積書から納品書を作成します。※現在v3 APIでは納品書作成エンドポイントが提供されていないため、このツールは機能しません。納品書はマネーフォワードのWebUIから作成してください。 |
| mf_expense_auth_startB | 経費API OAuth認証を開始します。デフォルトはOOBモード（認証コードが画面に表示される）。 |
| mf_expense_auth_statusB | 経費API認証状態を確認します |
| mf_expense_auth_callbackB | 経費API認証コードを使用してアクセストークンを取得します（OOBモードで認証後に使用） |
| mf_expense_list_officesB | 事業者一覧を取得します |
| mf_expense_list_transactionsC | 自分の経費明細一覧を取得します |
| mf_expense_get_transactionC | 経費明細の詳細を取得します |
| mf_expense_create_transactionC | 経費明細を作成します |
| mf_expense_update_transactionC | 経費明細を更新します |
| mf_expense_delete_transactionA | 経費明細を削除します。元に戻せません（コネクタに undo はありません）。実行前に対象の明細 ID・日付・金額・摘要をユーザーへ提示して確認を取ってください。 |
| mf_expense_list_reportsC | 自分の経費申請一覧を取得します |
| mf_expense_get_reportC | 経費申請の詳細と明細を取得します |
| mf_expense_approve_reportC | 経費申請を承認します |
| mf_expense_disapprove_reportC | 経費申請を却下します |
| mf_expense_upload_receiptA | レシート画像・PDF をアップロードします。アップロードだけで経費明細が新規作成される場合があります（MF 側が OCR して明細を起票する）。添付のみを意図していて別途 mf_expense_create_transaction でも明細を作ると二重計上になるため、結果の「作成された明細数」を必ず確認してください。許可拡張子: jpg / jpeg / png / gif / heic / heif / pdf。認証情報ディレクトリ配下のファイルは拒否します。 |
| mf_expense_list_ex_itemsC | 経費科目一覧を取得します |
| mf_expense_list_deptsC | 部門一覧を取得します |
| mf_expense_list_projectsC | プロジェクト一覧を取得します |
| mf_accounting_auth_startB | 会計API OAuth認証を開始する。デフォルトはOOBモード（認証コードが画面に表示される）。 |
| mf_accounting_auth_statusB | 会計API認証状態を確認する |
| mf_accounting_auth_callbackB | 会計API認証コードを使用してアクセストークンを取得する（OOBモードで認証後に使用） |
| mf_accounting_refresh_tokenB | 会計API アクセストークンをリフレッシュする |
| mf_accounting_list_journalsB | 会計仕訳一覧を取得する。start_date または end_date のいずれかを指定する必要がある（同一会計期間内）。 |
| mf_accounting_get_journalC | 会計仕訳の詳細を取得する |
| mf_accounting_create_journalA | 会計仕訳を新規作成する（POST /api/v3/journals）。dry_run=true の場合は API を呼ばず、組み立てたリクエストボディを JSON で返す。冪等性キー（memo の決定的キー、tags=mf-mcp:auto 等）は呼び出し側で組み立てて memo / tags に渡すこと。事前に各 branch の借貸合計が一致することを検証する。 |
| mf_accounting_update_journalA | 既存の会計仕訳を更新する（PUT /api/v3/journals/{id}）。dry_run=true の場合は API を呼ばず、組み立てたリクエストボディを JSON で返す。事前に各 branch の借貸合計が一致することを検証する。 |
| mf_accounting_delete_journalA | 会計仕訳を削除する（DELETE /api/v3/journals/{id}）。不可逆操作。誤削除防止のため confirm=true を必ず指定する。 |
| mf_accounting_list_accountsC | 勘定科目一覧を取得する |
| mf_accounting_list_sub_accountsC | 補助科目一覧を取得する |
| mf_accounting_list_taxesC | 税区分一覧を取得する |
| mf_accounting_list_departmentsC | 部門一覧を取得する |
| mf_accounting_get_officeA | 現在の事業者情報と会計期間を取得する |
| mf_accounting_list_term_settingsB | 会計年度設定一覧を取得する |
| mf_accounting_list_trade_partnersC | 取引先一覧を取得する（会計） |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 56 tools
Tools are organized by domain (quotes, billings, expenses, accounting) with consistent prefixes, but there is overlap: mf_create_billing and mf_create_billing_from_quote both create billings, and mf_convert_quote_to_billing vs mf_create_billing_from_quote likely do the same thing. Auth tools are duplicated across three API surfaces (root, expense, accounting), which could confuse an agent about which to use.
Almost all tools follow a clear mf_<domain>_<verb>_<noun> pattern (e.g., mf_expense_create_transaction, mf_accounting_create_journal). A few root-level tools lack the domain prefix (mf_list_partners, mf_get_item), creating minor inconsistency, but the overall scheme is deterministic.
56 tools is very heavy for a single connector, and the surface spans four distinct APIs (quotes/billings, expenses, accounting, auth) with duplicated auth machinery. A more modular design (one server per MF API) would reduce selection errors.
Core CRUD is mostly covered for billings, expenses, journals, and quotes, but there are gaps: no create/update for quotes' related entities (partners, items), no payment status listing/details, and one tool (mf_create_delivery_slip) is explicitly non-functional. The surface is broad but not consistently complete across sub-domains.