Skip to main content
Glama
kentaroajisaka

mf-api-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MF_API_KEYNoThe Money Forward API key. Required if MF_API_KEY_FILE or the default key file (~/.mf-api-key) are not used.
MF_OFFICE_CODENoDefault office code. If omitted, the office_code parameter is required for all tools.
MF_API_KEY_FILENoPath 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.7/5.0

Scored across 26 tools

Disambiguation4/5

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.

Naming Consistency3/5

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`.

Tool Count2/5

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.

Completeness3/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo issues