MCP 服务器

freee-chat-mcp-server

Enables Claude Desktop to interact with freee accounting API for expense registration, transaction management, and receipt image processing.

README

freee-chat-mcp-server 💸

freee会計APIをClaude Desktopで簡単に使えるMCPサーバーです。経費登録、取引管理、帳票確認などがClaude上で直接操作できます。

主な機能

スマート経費登録

create_smart_expense: 経費の種類を指定するだけで、適切な勘定科目と税区分を自動選択
軽減税率（食品8%）と標準税率（10%）に自動対応
レシート画像アップロード対応: レシート・領収書の画像をClaude Desktopにアップロードすると、画像の内容を読み取って自動で経費登録
画像から金額、店舗名、購入内容を自動抽出して経費データとして活用可能

会社管理

suggest_company: 複数会社がある場合の自動選択・提案
list_companies: アクセス可能な全事業所の一覧取得

経費管理

suggest_common_expenses: よく使う経費科目の提案（交際費、旅費交通費、消耗品費など）
get_recent_deals: 最近の取引一覧表示
delete_deal: 間違って登録した取引の削除

取引・帳票

create_deal: 取引（収入・支出）の作成
list_deals: 取引一覧の取得（期間・種類での絞り込み可能）
list_account_items: 勘定科目一覧
list_partners: 取引先一覧
list_taxes: 税区分一覧

必要なもの

Claude Desktop
freee会計のアカウント
freeeのアクセストークン（freee developersで取得）
Node.js 18以上

インストール方法

1. リポジトリをクローン

git clone https://github.com/YOUR_USERNAME/freee-mcp-server.git
cd freee-mcp-server

2. 依存関係をインストール

npm install

3. ビルド

npm run build

4. freeeアクセストークンの取得

freee developersにアクセス
アプリケーションを作成
アクセストークンを取得

5. Claude Desktopの設定

Claude Desktopの設定ファイルを開きます：

macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

設定ファイルに以下を追加：

{
  "mcpServers": {
    "freee": {
      "command": "node",
      "args": ["/path/to/freee-mcp-server/dist/index.js"],
      "env": {
        "FREEE_ACCESS_TOKEN": "your_freee_access_token_here"
      }
    }
  }
}

注意: /path/to/freee-mcp-serverは実際のプロジェクトのパスに置き換えてください。

6. Claude Desktopを再起動

設定を反映するためにClaude Desktopを再起動してください。

使用例

レシート画像からの経費登録

1. Claude Desktopにレシート・領収書の画像をアップロード
2. 「この画像から経費登録して」と依頼
3. Claudeが画像を解析して金額、店舗名、内容を抽出
4. create_smart_expense で自動で適切な勘定科目・税区分を選択して登録

スマート経費登録

食材の買い物を経費登録したい

create_smart_expense を使用:
- company_id: 12345
- amount: 1500
- description: "スーパーマーケット - 野菜、肉類"
- expense_type: "food"
- transaction_date: "2024-01-15"

→ 自動で「消耗品費」+ 軽減税率8%で登録

間違った登録の修正

1. get_recent_deals で最近の取引を確認
2. delete_deal で間違った取引を削除
3. 正しい内容で再登録

会社の自動選択

suggest_company を実行
→ 複数会社がある場合は選択肢を表示
→ 単一会社の場合は自動選択

設定オプション

環境変数

変数名	説明	必須
`FREEE_ACCESS_TOKEN`	freee APIアクセストークン	はい

経費の種類 (expense_type)

種類	説明	自動選択される勘定科目	税区分
`food`	食品・飲食物	消耗品費	軽減税率8%
`office_supplies`	事務用品	消耗品費・事務用品費	標準税率10%
`transportation`	交通費	旅費交通費	標準税率10%
`utilities`	光熱費	水道光熱費	標準税率10%
`rent`	地代家賃	地代家賃	標準税率10%
`entertainment`	接待・会議	交際費・会議費	標準税率10%
`other`	その他	雑費・消耗品費	標準税率10%