Freee Mcp Solo
About
A use-case driven MCP server for freee accounting, designed for sole proprietors in Japan.
Details
- Author
- kogasura
- Downloads
- 328
- Categories
- Finance
Jump to
- Use-case driven: optimized for actual accounting workflows, not a raw API wrapper.
- Name-based operations: specify accounts, partners, and banks by name.
- Flexible YAML configuration for payment details, due date rules, and subject templates.
- Automatic full-width/half-width normalization for matching bank names.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Freee Mcp SoloCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install globally with npm install -g freee-mcp-solo, create a configuration file at ~/.config/freee-mcp-solo/config.yaml with freee developer credentials, and register the server in your MCP client (Claude Code or Claude Desktop) by adding the command to the appropriate config file. After setup, run the authenticate tool to obtain OAuth tokens.
authenticate
OAuth認証の開始・状態確認。初回認証やトークン失効時に使用。
pending_transactions
未処理（未仕訳）の口座明細一覧を取得する。口座名や期間で絞込可能。
create_deal
取引（仕訳）を登録する。勘定科目は名前で指定。税区分は勘定科目のデフォルトを自動適用。口座指定で明細と自動紐付け。
monthly_summary
月次の収支サマリーを勘定科目別に集計して表示する。
create_invoice
請求書を作成する（下書き）。取引先名で指定。入金期日は設定ファイルのルールから自動計算。明細は複数行対応。
list_invoices
請求書の一覧を取得する。取引先名で絞込可能。
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"freee mcp solo": {
"freee-solo": {
"command": "npx",
"args": [
"-y",
"freee-mcp-solo"
]
}
}
}
}McpServers
{
"freee-solo": {
"command": "npx",
"args": [
"-y",
"freee-mcp-solo"
]
}
}freee-mcp-solo
個人事業主・フリーランスの日常経理に特化した freee会計 用 MCP (Model Context Protocol) サーバー。
Claude Code や Claude Desktop から、仕訳登録・請求書作成・月次確認をシンプルなツール呼び出しで実行できます。
特徴
- ユースケース駆動 — freee API の 1:1 ラッパーではなく、「仕訳」「請求書作成」「月次確認」という実際の業務に最適化
- 名前ベースの操作 — 勘定科目・取引先・口座を名前で指定。ID への変換はサーバーが自動処理
- 設定ファイルで柔軟に — 振込先、入金期日ルール、件名テンプレートを YAML で管理
- 全角/半角を自動正規化 — 「PayPay銀行」で「ＰａｙＰａｙ銀行（API）」にマッチ
ツール一覧
| ツール | 用途 |
|---|---|
| authenticate | OAuth認証・状態確認 |
| pending_transactions | 未処理（未仕訳）の口座明細を一覧表示 |
| create_deal | 取引（仕訳）を登録 |
| monthly_summary | 月次の収支を勘定科目別に集計 |
| create_invoice | 請求書を作成（下書き） |
| list_invoices | 請求書の一覧を表示 |
前提条件
- 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 build
2. 設定ファイルの作成
mkdir -p ~/.config/freee-mcp-solo
cp config.example.yaml ~/.config/freee-mcp-solo/config.yaml
config.yaml に freee アプリの認証情報と振込先を設定:
```yaml
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
