freee-mcp-solo
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., "@freee-mcp-solo 今月の収支を教えて"
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.
freee-mcp-solo
個人事業主・フリーランスの日常経理に特化した freee会計 用 MCP (Model Context Protocol) サーバー。
Claude Code や Claude Desktop から、仕訳登録・請求書作成・月次確認をシンプルなツール呼び出しで実行できます。
特徴
ユースケース駆動 — freee API の 1:1 ラッパーではなく、「仕訳」「請求書作成」「月次確認」という実際の業務に最適化
名前ベースの操作 — 勘定科目・取引先・口座を名前で指定。ID への変換はサーバーが自動処理
設定ファイルで柔軟に — 振込先、入金期日ルール、件名テンプレートを YAML で管理
全角/半角を自動正規化 — 「PayPay銀行」で「PayPay銀行(API)」にマッチ
Related MCP server: freee MCP Server
ツール一覧
ツール | 用途 |
| OAuth認証・状態確認 |
| 未処理の口座明細を一覧表示 |
| 取引(仕訳)を登録 |
| 月次の収支を勘定科目別に集計 |
| 登録済みの取引を科目・期間で絞込表示 |
| 請求書を作成(下書き) |
| 請求書の一覧を表示 |
注意:
pending_transactionsが返す「未処理明細」は 未仕訳の明細ではありません。freee は取引を登録しても口座明細の消し込み(マッチング)を自動では行わないため、仕訳済みの明細も一覧に残り続けます。一覧をそのままcreate_dealでループ処理すると二重計上になります。仕訳前にlist_dealsで既存取引を確認し、突合してから登録してください。
前提条件
Node.js 20 以上
freee 会計アカウント(個人事業主プラン以上)
freee 開発者アプリの Client ID / Client Secret(開発者ページで取得)
セットアップ
1. インストール
npm install -g freee-mcp-soloまたは、ソースからビルド:
git clone https://github.com/kogasura/freee-mcp-solo.git
cd freee-mcp-solo
npm install
npm run build2. 設定ファイルの作成
mkdir -p ~/.config/freee-mcp-solo
cp config.example.yaml ~/.config/freee-mcp-solo/config.yamlconfig.yaml に freee アプリの認証情報と振込先を設定:
# freee API 認証情報
auth:
client_id: "your_client_id" # freee 開発者ページで取得
client_secret: "your_client_secret"
callback_port: 54321
# company_id, company_name は初回認証時に自動設定されます
# 振込先情報(請求書に記載)
payment:
bank_info: "○○銀行 △△支店 普通 1234567 カ)サンプル"
# 請求書のデフォルト設定
invoice:
tax_entry_method: exclusive # exclusive(外税) / inclusive(内税)
default_account_item: "売上高"
layout: default_classic
message: "下記の通りご請求申し上げます。"
# 取引先ごとの設定
partners:
株式会社サンプル:
due_date_rule: "+1month_end" # 翌月末
partner_title: "御中"
subject_template: "開発費_{YY}年{MM}月"入金期日ルール (due_date_rule)
ルール | 意味 |
| 翌月末日 |
| 翌々月15日 |
| 翌月20日 |
| 30日後 |
件名テンプレート (subject_template)
変数 | 展開結果 |
| 4桁の年(例: 2026) |
| 2桁の年(例: 26) |
| 2桁の月(例: 03) |
| 月(例: 3) |
3. Claude Code / Claude Desktop に登録
.mcp.json に以下を追加:
{
"mcpServers": {
"freee-solo": {
"type": "stdio",
"command": "freee-mcp-solo"
}
}
}ソースからビルドした場合:
{
"mcpServers": {
"freee-solo": {
"type": "stdio",
"command": "node",
"args": ["/path/to/freee-mcp-solo/dist/index.js"]
}
}
}Claude Desktop の場合は claude_desktop_config.json に同様の設定を追加:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
4. 初回認証
Claude Code で authenticate ツールを実行すると、ブラウザで freee のログイン画面が開きます。ログイン・認可すると OAuth トークンが保存され、事業所情報が config.yaml に自動設定されます。
使い方
仕訳作業
ユーザー: 未処理の明細を仕訳して
Claude: pending_transactions() を実行
→ 未処理明細 5件:
#1 03/25 出金 ¥1,100 さくらインターネット
#2 03/25 出金 ¥2,200 ANTHROPIC
...
Claude: list_deals(account_item: "通信費") で既存取引と突合
→ #2 の ¥2,200 は登録済み。残り4件が未計上
Claude: 以下の仕訳でよいですか?
#1 通信費 / さくらインターネット / レンタルサーバー
...
ユーザー: ok
Claude: create_deal() x 4 を実行 → 登録完了
Claude: monthly_summary() で件数・金額が想定どおりか検算請求書作成
ユーザー: 今月の請求書を30万で作って
Claude: create_invoice(
partner_name: "株式会社サンプル",
issue_date: "2026-03-31",
items: [{ description: "開発費_26年03月", qty: 1, unit_price: 300000 }]
)
→ 請求書を作成しました (ID: 12345)
請求番号: INV-0000000001
金額: ¥300,000(税抜) / ¥330,000(税込)
入金期日: 2026-04-30(自動計算)月次確認
ユーザー: 今月の収支は?
Claude: monthly_summary()
→ 2026年3月 収支サマリー
収入: ¥990,000
支出: ¥234,567
差引利益: ¥755,433内訳の確認
monthly_summary は科目別の合計しか返しません。内訳を見るには list_deals を使います。
ユーザー: 3月の支払手数料の中身は?
Claude: list_deals(
start_date: "2026-03-01",
end_date: "2026-03-31",
account_item: "支払手数料"
)
→ 取引一覧: 4件(2026-03-01 〜 2026-03-31/科目: 支払手数料)
#1 (id:xxx) 03-01 支出 ¥145 支払手数料 [PayPay銀行]
#2 (id:xxx) 03-09 支出 ¥145 支払手数料 [PayPay銀行]
...
表示分合計: ¥580使用する freee API
API | エンドポイント | 用途 |
会計 API |
| 仕訳・口座明細・マスタデータ |
請求書 API |
| 請求書の作成・一覧 |
ライセンス
MIT
Available Tools
7 toolsauthenticateA
OAuth認証の開始・状態確認。初回認証やトークン失効時に使用。
Inputs: no named parameters.
create_dealA
取引(仕訳)を登録する。勘定科目は名前で指定。税区分は勘定科目のデフォルトを自動適用。口座指定で明細と自動紐付け。
Inputs: type (required), amount (required), issue_date (required), account_item (required), +3 more.
create_invoiceA
請求書を作成する(下書き)。取引先名で指定。入金期日は設定ファイルのルールから自動計算。明細は複数行対応。
Inputs: items (required), issue_date (required), partner_name (required), subject, +1 more.
list_dealsA
登録済みの取引(仕訳)一覧を取得する。勘定科目名や期間で絞込可能。monthly_summaryの内訳確認や、仕訳の重複チェックに使う。
Inputs: type, limit, end_date, start_date, +1 more.
list_invoicesB
請求書の一覧を取得する。取引先名で絞込可能。
Inputs: limit, partner_name.
monthly_summaryA
月次の収支サマリーを勘定科目別に集計して表示する。
Inputs: year, month.
pending_transactionsA
未処理(未仕訳)の口座明細一覧を取得する。口座名や期間で絞込可能。
Inputs: limit, end_date, start_date, wallet_name.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct resource/action: authentication, unprocessed transactions, deal creation, monthly summary, deal listing, invoice creation, and invoice listing. There is no overlap or ambiguity among them.
Most tools follow a verb_noun pattern (create_deal, list_deals, create_invoice, list_invoices), but authenticate, pending_transactions, and monthly_summary deviate. The naming is still readable and consistently snake_case, so only minor deviations.
Seven tools is well within the ideal 3-15 range and covers the server's accounting scope without unnecessary bloat. Each tool serves a clear purpose.
Core create/list workflows exist for deals and invoices, but there are no update or delete operations for either entity. This is a notable gap that could leave agents unable to correct errors or manage drafts fully.
Maintenance
Related MCP Connectors
Malaysian SME accounting, e-Invoice and payroll for your AI. 95 tools; writes are approved drafts.
Create, send and track invoices from a conversation in Claude, ChatGPT or any MCP client that supports OAuth. Draft an invoice from one sentence or from last month's invoice for the same client, finalize it, email it to your client and send payment reminders for overdue ones. See revenue by month and by client, download PDFs and e-invoices (ZUGFeRD, XRechnung), and export DATEV packages for your tax advisor. Invoices follow the tax rules of 25 countries, including reverse charge and the small-business VAT exemption. New invoices are drafts, and nothing is emailed until you ask. Pay per invoice with no subscription: the first invoice is free.
AI agents for bookkeeping, reconciliation, and financial close for SMBs.
Your books in your AI assistant: draft expenses, bills, invoices, estimates; ask about P&L, tax.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to access and manage accounting data through the freee accounting API, supporting operations like transaction management, financial analysis, and account item management.547 npm1-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with freee accounting software through OAuth 2.0 authentication, supporting operations like transaction creation, account management, receipt uploads, and financial statement retrieval.MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with freee accounting software API for managing companies, transactions, invoices, and reports via OAuth authentication.603MIT
- AlicenseCqualityDmaintenanceEnables AI agents to interact with the freee accounting API, offering tools for managing deals, invoices, partners, trial balance, and more via natural language.21MIT