mf-accounting-voucher-mcp
Click on "Deploy 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-accounting-voucher-mcp Attach the file /tmp/receipt.pdf to journal entry 12345"
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-accounting-voucher-mcp
A local MCP server that complements features not supported by the official MCP server for マネーフォワード クラウド会計. It calls the REST API v3 directly and is used alongside the official MCP (remote).
Provided Tools
Tool name | Function | API endpoint |
| Attach voucher files (PDF/images) to journal entries |
|
| Remove voucher attachments |
|
| Delete journal entries (irreversible) |
|
Note: Marking linked details as "excluded" is not available in the REST API, so this is not provided. Downloading voucher files is likewise not supported by the API. Features already provided by the official MCP (such as
getJournals) are not reimplemented.
Voucher file binaries do not pass through the LLM. This server (a Node process) receives a local file path, reads it, base64-encodes it, and sends it to the API.
Related MCP server: money-forward-mcp-community
Setup
1. Register an app in the App Portal
Create an app in the マネーフォワード App Portal and configure the following.
Redirect URI:
http://127.0.0.1:53682/callbackScopes:
mfc/accounting/voucher.write(registering and deleting vouchers)mfc/accounting/journal.write(registering, updating, and deleting journal entries)
Note down the issued client ID / client secret.
2. Installation and build
pnpm install && pnpm run build3. Environment variable configuration
export MF_CLIENT_ID="(クライアントID)"
export MF_CLIENT_SECRET="(クライアントシークレット)"Variable | Default | Purpose |
| None (required) | Issued in the App Portal |
|
| Local port for the callback |
|
| Redirect URI |
|
| Token storage location |
|
| Per-file limit (local safety valve) |
|
| Allowed extensions (overridable as comma-separated list) |
4. Initial authorization
pnpm run authA browser opens, so log in to マネーフォワード and authorize. The token is saved to ~/.mf-accounting-voucher-mcp/tokens.json (mode 600) and is automatically refreshed thereafter.
Registering with Claude Desktop / Cowork
Once registered, the MCP server starts automatically when the client launches. No manual startup is needed in daily use.
Recommended: Using the keychain (without writing secrets to the config file)
Only on the first run, register the credentials in the macOS keychain:
security add-generic-password -s mf-accounting-voucher-mcp -a client_id -w '(クライアントID)' -U
security add-generic-password -s mf-accounting-voucher-mcp -a client_secret -w '(クライアントシークレット)' -URegister the startup script in mcpServers in claude_desktop_config.json (replace the path with your actual installation location):
{
"mcpServers": {
"mf-accounting-voucher-mcp": {
"command": "/path/to/mf-accounting-voucher-mcp/scripts/mf-accounting-voucher-mcp.sh",
"args": []
}
}
}The initial OAuth authorization can also be run via the script (no environment variable configuration needed):
scripts/mf-accounting-voucher-mcp.sh authAlternative: Writing environment variables directly in the config file
{
"mcpServers": {
"mf-accounting-voucher-mcp": {
"command": "node",
"args": ["/path/to/mf-accounting-voucher-mcp/dist/index.js"],
"env": {
"MF_CLIENT_ID": "(クライアントID)",
"MF_CLIENT_SECRET": "(クライアントシークレット)"
}
}
}
}Note that with this method, secrets remain in plain text in the config file.
Usage example
「この領収書(/Users/xxx/Downloads/receipt.pdf)を仕訳 XXXX に添付して」
→ post_vouchers が呼ばれ、添付結果(voucher_file_ids)が返る
「仕訳 XXXX の証憑 a60cd25d-... の添付を解除して」
→ delete_voucher
「仕訳 XXXX を削除して」
→ delete_journal(実行前に仕訳内容の提示と明示的な確認が入る)The attachment result can be verified by retrieving the target journal entry with the official MCP's getJournalById and confirming it is reflected in voucher_file_ids.
Notes
For the exact MF limits on file type, size, and count, refer to the official specification
/specs/vouchers(this server's limits are a local safety valve)Switching business entities (offices) is done by re-running
pnpm run authdelete_journalcannot be undone. The caller (LLM) is designed to obtain explicit user confirmation before executing
Available Tools
3 toolsdelete_journalA
マネーフォワード クラウド会計の仕訳を削除する。この操作は元に戻せません。実行前に必ずユーザーの明示的な確認を取り、対象仕訳の内容(取引No・日付・金額・摘要)を提示してから呼び出すこと。
Inputs: id (required).
delete_voucherA
マネーフォワード クラウド会計の仕訳から証憑ファイルの添付を解除する(添付解除。ファイル自体の削除ではなく仕訳との紐付けを外す操作)。
Inputs: journal_id (required), voucher_file_id (required).
post_vouchersA
マネーフォワード クラウド会計の仕訳に証憑ファイル(PDF・画像)を添付する。ファイルはローカルの絶対パスで指定し、サーバー側で読み込んでbase64送信する(ファイル内容はLLMを経由しない)。
Inputs: file_paths (required), journal_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
post_vouchers与delete_voucher都涉及証憑添付,前者是添付、后者是解除添付,边界清晰;但delete_voucher和delete_journal都含'delete'前缀,容易混淆,且语义上一个删除附件、一个删除仕訳本身,描述虽说明但名称上不够鲜明。整体可区分但有轻微重叠。
工具名采用动词+名词的snake_case(post_vouchers, delete_voucher, delete_journal),但动词风格不一致:post是动作,delete重复使用,且voucher与journal概念不同但都涉及删除,名词部分略显混乱。整体模式可识别但不够统一。
3个工具属于偏少但可接受的范围。对于会计凭证管理,可能预期有获取/查询工具,但当前仅有写入和删除操作,功能面较窄,工具数接近最低阈值。
缺少核心的获取/查询功能(如获取凭证列表、获取仕訳详情),也缺少更新操作。用户无法查看已存在的凭证或仕訳,仅能添加和删除,导致操作闭环不完整,代理将面临无法验证或修订的困境。
Maintenance
Related MCP Connectors
Secure remote MCP for supported accounting workflows in authorized Money S3 companies.
e-Boekhouden MCP server for ChatGPT, Claude and any AI agent: create invoice, book mutation, add relation, list open items and export ledger in your own e-Boekhouden account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to e-Boekhouden yourself; Cotlet does not store your password and you need no e-Boekhouden API key. About the official e-Boekhouden API: Yes. e-Boekhouden has a REST API with an OpenAPI description (checked 14 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/e-boekhouden-api-mcp-server
Headless API-first double-entry accounting & bookkeeping engine. 84 MCP tools over HTTP.
Bokio MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, upload receipt, create journal entry and list unpaid invoices in your own Bokio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Bokio yourself; Cotlet does not store your password and you need no Bokio API key. About the official Bokio API: Yes, Bokio has a public REST API for invoices, customers, journal entries, uploads and supplier invoices (checked 14 Oct 2026), but it depends on your price plan and on the kind of integration: a private integration token works for one company only, and a tool that serves several companies must be registered as a public integration with OAuth 2.0. Bokio publishes no MCP server of its own. Setup and FAQ: https://cotlet.dev/integrations/bokio-api-mcp-server
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude Desktop to interact with freee accounting API for expense registration, transaction management, and receipt image processing.151MIT
- AlicenseAqualityCmaintenanceUnofficial, community-maintained stdio MCP server for Money Forward ME that uses cookie-based authentication to retrieve accounts and assets from manual entry accounts.1436 npm9MIT
- AlicenseBqualityCmaintenanceAn unofficial MCP server for Money Forward Cloud Accounting that extends the official beta MCP by enabling simultaneous connections to multiple businesses, attaching receipts and invoices to journal entries, and fully deleting journal entries.29MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to operate MoneyForward Cloud Invoice, Expense, and Accounting through their public APIs, exposing 56 tools for issuing invoices, filing expenses with receipt images, and posting journal entries.569 npmMIT