@jp-mcp/server-moneyforward

日本語 | English

日本語

マネーフォワード クラウドの各サービスにAIエージェントから直接アクセスできる、オープンソースのMCPサーバーです。

Note: マネーフォワード社は公式MCPサーバーβ版を提供していますが、公認メンバー（プラチナ）限定の招待制です。本サーバーは誰でも即インストールして使えるOSS版として、テスト43本・CI完備の品質で提供しています。

特徴

• 🔧 16ツール — 会計・請求書・経費・給与の4サービスに対応
• ✅ テスト43本 — バリデーション・サニタイズ・レートリミット含む
• 🔒 セキュリティ — 入力サニタイズ・レートリミット・APIキー環境変数管理
• 📦 即使える — npx 1行で起動。インストール不要
• 🇯🇵 日本語フルサポート — README・エラーメッセージ・ツール説明すべて日本語対応
• 🤖 MCP SDK準拠 — Claude Desktop / Cursor / 任意のMCPクライアントで動作

対応サービス

| サービス | ステータス | 機能 | |----------|-----------|------| | クラウド会計 | ✅ 対応済み | 取引CRUD / 仕訳帳 / 勘定科目 / 取引先 / 試算表 / 口座残高 | | クラウド請求書 | ✅ 対応済み | 請求書一覧 / 作成 / 詳細取得 | | クラウド経費 | ✅ 対応済み | 経費申請一覧 / 登録 | | クラウド給与 | 🔧 基本対応 | 従業員一覧 |

クイックスタート

# npxで直接実行（インストール不要）
npx @jp-mcp/server-moneyforward

# またはグローバルインストール
npm install -g @jp-mcp/server-moneyforward

環境変数

| 変数名 | 必須 | 説明 | |--------|------|------| | MF_ACCESS_TOKEN | ◎ | OAuth2.0 アクセストークン | | MF_REFRESH_TOKEN | △ | OAuth2.0 リフレッシュトークン（トークン自動更新用） | | MF_API_KEY | ◎ | APIキー（サーバー間通信用） | | MF_OFFICE_ID | ◎ | 事業所ID | | MF_CLIENT_ID | △ | OAuth2.0 Client ID（自動更新に必要） | | MF_CLIENT_SECRET | △ | OAuth2.0 Client Secret（自動更新に必要） |

*MF_ACCESS_TOKEN または MF_API_KEY のどちらか一方が必須です。 *MF_REFRESH_TOKEN + MF_CLIENT_ID + MF_CLIENT_SECRET を設定すると、アクセストークン期限切れ時に自動リフレッシュします。

Claude Desktop での設定

claude_desktop_config.json:

{
  "mcpServers": {
    "moneyforward": {
      "command": "npx",
      "args": ["@jp-mcp/server-moneyforward"],
      "env": {
        "MF_API_KEY": "your-api-key",
        "MF_OFFICE_ID": "your-office-id"
      }
    }
  }
}

使い方の例

AIに以下のような指示ができます：

• 「今月の売上を集計して」
• 「未払いの請求書一覧を見せて」
• 「先月の試算表を出して」
• 「取引先○○への請求書を作成して」
• 「今月の経費を一覧表示して」
• 「口座残高を確認して」

ツール一覧（16ツール）

| ツール名 | 説明 | |---------|------| | mf_get_tenant | テナント（事業者）情報取得 | | mf_list_deals | 取引一覧（期間・取引先でフィルタ） | | mf_get_deal | 取引詳細 | | mf_create_deal | 取引作成 | | mf_list_journals | 仕訳帳データ | | mf_list_accounts | 勘定科目一覧 | | mf_list_partners | 取引先一覧（検索可能） | | mf_get_trial_balance | 試算表 | | mf_list_wallets | 口座残高一覧 | | mf_list_invoices | 請求書一覧 | | mf_get_invoice | 請求書詳細 | | mf_create_invoice | 請求書作成 | | mf_list_expenses | 経費一覧 | | mf_create_expense | 経費登録 | | mf_list_employees | 従業員一覧 | | mf_get_office | 事業所情報 |

セキュリティ

• APIキーはすべて環境変数で管理（コード内にハードコードしない）
• 入力パラメータのバリデーション・サニタイズ
• レートリミット（429レスポンス対応）
• 詳細は SECURITY.md を参照

テスト

npm test
# 43 tests passed

English

Open-source MCP Server for Money Forward Cloud — Japan's leading cloud accounting platform with 100,000+ business users.

Note: Money Forward Inc. offers an official MCP server (β), but it is invite-only for certified Platinum members. This server is a fully open-source alternative available to anyone via npm, with 43 tests and full CI coverage.

Features

• 🔧 16 tools — Accounting, Invoicing, Expenses, Payroll
• ✅ 43 tests — Validation, sanitization, rate limiting
• 🔒 Security-first — Input sanitization, rate limiting, env-based key management
• 📦 Zero-install — Run with npx instantly
• 🇯🇵 Full Japanese support — README, errors, tool descriptions
• 🤖 MCP SDK compliant — Works with Claude Desktop, Cursor, any MCP client

Quick Start

npx @jp-mcp/server-moneyforward

Supported Services

| Service | Status | Features | |---------|--------|----------| | Cloud Accounting | ✅ Ready | Deals CRUD / Journals / Accounts / Partners / Trial Balance / Wallets | | Cloud Invoice | ✅ Ready | List / Create / Get invoices | | Cloud Expense | ✅ Ready | List / Create expenses | | Cloud Payroll | 🔧 Basic | Employee list |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MF_ACCESS_TOKEN | Yes* | OAuth2.0 access token | | MF_REFRESH_TOKEN | No | OAuth2.0 refresh token (for auto-refresh) | | MF_API_KEY | Yes* | API key (for server-to-server) | | MF_OFFICE_ID | Yes | Office/Company ID | | MF_CLIENT_ID | No | OAuth2.0 Client ID (required for auto-refresh) | | MF_CLIENT_SECRET | No | OAuth2.0 Client Secret (required for auto-refresh) |

*Either MF_ACCESS_TOKEN or MF_API_KEY is required.

License

MIT

Contributing

Issues and PRs welcome! See CONTRIBUTING.md.

Made with 🖤 by jp-mcp — Building open-source MCP servers for Japanese SaaS