freee-chat-mcp-server
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-chat-mcp-server Register this receipt as a food expense"
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-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: 税区分一覧
Related MCP server: freee MCP Server
必要なもの
freee会計のアカウント
freeeのアクセストークン(freee developersで取得)
Node.js 18以上
インストール方法
1. リポジトリをクローン
git clone https://github.com/YOUR_USERNAME/freee-mcp-server.git
cd freee-mcp-server2. 依存関係をインストール
npm install3. ビルド
npm run build4. freeeアクセストークンの取得
freee developersにアクセス
アプリケーションを作成
アクセストークンを取得
5. Claude Desktopの設定
Claude Desktopの設定ファイルを開きます:
macOS:
open ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
%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 APIアクセストークン | はい |
経費の種類 (expense_type)
種類 | 説明 | 自動選択される勘定科目 | 税区分 |
| 食品・飲食物 | 消耗品費 | 軽減税率8% |
| 事務用品 | 消耗品費・事務用品費 | 標準税率10% |
| 交通費 | 旅費交通費 | 標準税率10% |
| 光熱費 | 水道光熱費 | 標準税率10% |
| 地代家賃 | 地代家賃 | 標準税率10% |
| 接待・会議 | 交際費・会議費 | 標準税率10% |
| その他 | 雑費・消耗品費 | 標準税率10% |
質問(FAQ)
Q1: 「401 Unauthorized」エラーが出る
A: アクセストークンの問題です:
freee developersでトークンを再発行する
Claude Desktopの設定ファイルでトークンを更新する
トークンの権限(経費申請、取引管理)が有効か確認する
Q2: 間違って経費を登録してしまった
A: 削除機能を使用してください:
get_recent_dealsで最近の取引を確認削除したい取引のIDを確認
delete_dealで該当する取引を削除
Q3: 軽減税率と標準税率が自動で判別されない
A: expense_typeを正しく指定してください:
食品・飲食物 →
"food"(軽減税率8%)その他の消耗品 →
"office_supplies"(標準税率10%)手動で勘定科目を指定したい場合は
create_dealを使用
コントリビューション
バグ報告や機能要望はIssuesでお知らせください。
プルリクエストも歓迎します!
ライセンス
MIT License
関連リンク
Available Tools
15 toolsanalyze_expense_typeB
Analyze expense description to suggest the most appropriate expense type and account item
Inputs: description (required).
create_dealC
Create a new deal (income/expense transaction)
Inputs: type (required), details (required), company_id (required), issue_date (required), +1 more.
create_expenseB
Create a new expense entry in freee
Inputs: amount (required), company_id (required), expense_application_line_template_id (required), description, +1 more.
create_smart_expenseB
Create expense with smart suggestions for account items and tax codes. Use this for easier expense creation.
Inputs: amount (required), company_id (required), description (required), expense_type, +1 more.
delete_dealA
Delete a deal (income/expense transaction) by ID. Use this to correct mistakes.
Inputs: deal_id (required), company_id (required).
get_recent_dealsB
Get recent deals to find deal IDs for deletion or review
Inputs: company_id (required), limit.
list_account_itemsC
List account items (勘定科目)
Inputs: company_id (required).
list_companiesA
List all companies accessible by the user
Inputs: no named parameters.
list_dealsB
List deals (income/expense transactions)
Inputs: company_id (required), type, end_issue_date, start_issue_date.
list_expense_templatesB
List expense application line templates
Inputs: company_id (required).
list_partnersC
List partners (取引先)
Inputs: company_id (required).
list_taxesC
List tax codes
Inputs: company_id (required).
list_walletablesB
List walletables (bank accounts/credit cards)
Inputs: company_id (required).
suggest_common_expensesB
Get suggestions for common expense categories and their typical tax codes for easy expense entry
Inputs: company_id (required).
suggest_companyB
Get company suggestions based on user's preference. Ask user to choose which company to use if multiple companies exist.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Most tools have distinct purposes, but create_deal and create_expense could be confused as both create transactions; however, their descriptions clarify that create_deal is for general income/expense transactions while create_expense is specifically for expense entries.
All tools follow a consistent verb_noun pattern in snake_case (e.g., list_deals, create_expense, delete_deal), with clear verb choices that indicate the action.
Fifteen tools cover the essential operations for financial management (companies, deals, expenses, account items, taxes, partners, walletables, and suggestions) without being excessive.
The tool set includes create, read, and delete for deals but lacks an update operation, which is a notable gap for modifying transactions. Additionally, no tools exist for updating or deleting expenses beyond deals.
Related MCP Connectors
Connect Claude to Dutch accounting software: e-Boekhouden invoices, contacts and ledgers.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Connect ChatGPT and Claude to Fortnox: invoices, customers, reports. Every write needs your OK.
Read and write Sage Intacct from Claude or ChatGPT. Write tools are flagged for approval.
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.556 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
- AlicenseNot gradedqualityAmaintenanceAn MCP server and Claude plugin that enables interaction with freee APIs for accounting, human resources, invoicing, and more. It provides secure OAuth 2.0 authentication and integrates detailed API reference skills to support tasks like creating invoices and managing company data through natural language.22,270 npm518Apache 2.0
- AlicenseAqualityAmaintenanceEnables Claude to manage FreeAgent accounting tasks such as listing bank transactions, explaining and approving them with receipts, creating expenses, and logging mileage.2880 npm1MIT