mf-api-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MF_API_KEY | No | The Money Forward API key. Required if MF_API_KEY_FILE or the default key file (~/.mf-api-key) are not used. | |
| MF_OFFICE_CODE | No | Default office code. If omitted, the office_code parameter is required for all tools. | |
| MF_API_KEY_FILE | No | Path to a file containing the Money Forward API key. If MF_API_KEY is not set, the key is read from this file. |
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 | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_officesA | このAPIキーで使える事業者の一覧を表示する。MF から直接取得するので自前の台帳は無い。 |
| auth_statusA | APIキーの状態を確認する(キーの所在・JWTの取得可否・使える事業者数)。キーの値は表示しない。 |
| mf_api_infoA | このサーバーの設定情報と、OAuth版(mf-full)との違いを表示する。 |
| mfc_ca_currentOfficeC | 事業者情報と会計期間を取得します。 |
| mfc_ca_getTermSettingsA | 会計年度設定(税込/税抜・課税方式等)を取得します。 |
| mfc_ca_getAccountsC | 勘定科目を取得します。 |
| mfc_ca_getSubAccountsD | 補助科目を取得します。 |
| mfc_ca_getDepartmentsC | 部門を取得します。 |
| mfc_ca_getTaxesC | 税区分を取得します。 |
| mfc_ca_getTradePartnersC | 取引先を取得します。 |
| mfc_ca_postTradePartnersC | 取引先を作成します。 |
| mfc_ca_getConnectedAccountsB | 連携サービス(自動連携・手動管理とも)を取得します。 |
| mfc_ca_getJournalsC | 仕訳一覧を取得します。start_date または end_date のいずれかが必要。 |
| mfc_ca_getJournalByIdB | 仕訳を1件取得します。 |
| mfc_ca_postJournalsB | 仕訳を作成します(帳簿書き込み。要ユーザー承認)。 |
| mfc_ca_putJournalsA | 仕訳を更新します(全置換API・帳簿書き込み。要ユーザー承認)。 |
| mfc_ca_deleteJournalsB | 仕訳を完全削除します(公式MCP未提供・帳簿書き込み。要ユーザー承認)。 |
| mfc_ca_getReportsTrialBalanceBalanceSheetC | 貸借対照表の試算表(累計)を取得します。 |
| mfc_ca_getReportsTrialBalanceProfitLossC | 損益計算書の試算表(累計)を取得します。 |
| mfc_ca_getReportsTransitionBalanceSheetC | 貸借対照表の推移表(月別)を取得します。 |
| mfc_ca_getReportsTransitionProfitLossC | 損益計算書の推移表(月別)を取得します。 |
| mfc_ca_getTransactionsC | 連携サービスで収集された明細一覧を取得します(自動連携・手動とも)。 |
| mfc_ca_postTransactionsB | 手動管理の連携サービスに明細を作成します(要ユーザー承認)。 |
| mfc_ca_postTransactionJournalizeA | 明細から仕訳を作成します(帳簿書き込み。要ユーザー承認)。相手科目account_idのみ必須。貸借方向・口座側科目・税区分・invoice_kindはMFが自動補完。 |
| mfc_ca_postVouchersA | 証憑をアップロードし仕訳に添付します(公式MCP未提供・要ユーザー承認)。file_paths を渡せばローカルファイルを自動でbase64化する。journal_id 省略時は孤立証憑になる(後から仕訳に紐づける手段はない)ので原則指定すること。 |
| mfc_ca_deleteVouchersA | 仕訳と証憑の紐付けを解除します(証憑自体は孤立して残る。公式MCP未提供・要ユーザー承認)。 |
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 26 tools
Most tools map to a distinct resource/action, and the Japanese descriptions generally clarify the boundaries between journals, transactions, reports, and master data. A few pairs could still be confused, such as `postJournals` vs `postTransactionJournalize` and `getJournals` vs `getTransactions`, and `deleteVouchers` is misleading since it only unlinks rather than deletes a voucher.
The domain tools mostly follow a readable `mfc_ca_{HTTP verb}{Resource}` camelCase pattern, but the top-level utilities use a different snake_case style (`list_offices`, `auth_status`, `mf_api_info`). There are also odd deviations like `mfc_ca_currentOffice` with no verb and awkward report names such as `getReportsTrialBalanceBalanceSheet`.
26 tools is above the 25-tool threshold and feels heavy for a flat MCP surface. While most tools are individually distinct, several read-only master-data and report endpoints could be consolidated, making tool selection harder for an agent.
Core journal workflows are well covered with create, read, list, update, and delete, plus reports and transaction journalization. However, there are notable lifecycle gaps: trade partners and other master data are mostly read-only or create-only, vouchers cannot be listed or reattached after unlinking, and `postVouchers` can create orphan vouchers with no later attachment path.