Click on "Install 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 Servershow me this month's bank transactions"
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 Server
freee会計APIとClaude MCPを連携するサーバー。
概要
目的: Claudeからfreee会計データを操作（取引作成・口座確認・証憑アップロード・財務諸表取得等）
認証: OAuth 2.0 PKCE（ブラウザ認証）
token管理: 暗号化保存 + 自動リフレッシュ
実装言語: Python 3.13+
機能
MCPツール
ツール名 | 説明 | freee API |
| 事業所一覧取得 | GET /api/1/companies |
| 勘定科目一覧 | GET /api/1/account_items |
| 口座一覧 | GET /api/1/walletables |
| 口座明細一覧（元明細テキスト含む） | GET /api/1/wallet_txns |
| 取引一覧 | GET /api/1/deals |
| 請求書一覧 | GET /api/1/invoices |
| 取引先一覧 | GET /api/1/partners |
| 取引作成 | POST /api/1/deals |
| 証憑アップロード | POST /api/1/receipts |
| 貸借対照表（BS） | GET /api/1/reports/trial_bs |
| 損益計算書（PL） | GET /api/1/reports/trial_pl |
OAuth 2.0 PKCE認証フロー
1. ブラウザで認証URL起動
2. freeeログイン → 認可コード取得
3. アクセストークン取得 → 暗号化保存
4. リフレッシュトークンで自動更新セットアップ
1. freee Developersでアプリ登録
https://developer.freee.co.jp/
アプリケーション名: 任意（例:
freee-mcp-server）リダイレクトURI:
http://localhost:8080/callback必要なスコープ:
read:companies- 事業所情報read:accounts- 勘定科目read:walletables- 口座情報read:wallet_txns- 口座明細read:deals- 取引参照write:deals- 取引作成read:invoices- 請求書参照read:partners- 取引先参照write:receipts- 証憑アップロードread:reports- 財務諸表
CLIENT_ID と CLIENT_SECRET を取得してください。
2. 環境変数設定
cp .env.example .env
# .env を編集FREEE_CLIENT_ID=your_client_id
FREEE_CLIENT_SECRET=your_client_secret
FREEE_REDIRECT_URI=http://localhost:8080/callback
TOKEN_ENCRYPTION_KEY=generate_random_32_bytes
FREEE_COMPANY_ID=your_company_id暗号化キーの生成:
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"3. 依存関係のインストール
pip install -e .4. 初回認証
python src/auth.pyブラウザが開き、freeeログイン → tokenが ~/.freee-mcp/tokens.enc に保存されます。
5. MCPサーバー起動
python src/server.py6. Claude側設定
Claude Desktop の claude_desktop_config.json または Claude Code の .mcp.json:
{
"mcpServers": {
"freee": {
"command": "python",
"args": ["/path/to/freee-mcp/src/server.py"],
"env": {
"FREEE_CLIENT_ID": "your_client_id",
"FREEE_CLIENT_SECRET": "your_client_secret",
"FREEE_COMPANY_ID": "your_company_id",
"TOKEN_ENCRYPTION_KEY": "your_encryption_key"
}
}
}
}Claude Code Skills
Claude Codeで使える便利なSkillを同梱しています。
subscription-analyzer
口座明細からサブスクリプションを自動検出・分析します。
/subscription-analyzer機能:
80+サービスの自動検出（AI/ML, 開発ツール, クラウド等）
カテゴリ別コスト集計
重複課金・解約候補の提案
検出対象例:
カテゴリ | サービス |
AI/ML | ANTHROPIC, OPENAI, MIDJOURNEY, CURSOR |
クラウド | AWS, GCP, AZURE, VERCEL, FLY.IO |
開発ツール | GITHUB, NEON, SUPABASE, UPSTASH |
生産性 | NOTION, SLACK, ASANA, FIGMA |
詳細: .claude/skills/subscription-analyzer/SKILL.md
ディレクトリ構成
freee-mcp/
├── README.md
├── SETUP.md # 詳細セットアップガイド
├── LICENSE
├── pyproject.toml
├── .env.example
├── src/
│ ├── __init__.py
│ ├── server.py # MCPサーバーのメイン
│ ├── auth.py # OAuth 2.0 PKCE認証
│ ├── token_store.py # トークン暗号化保存
│ ├── freee_client.py # freee APIクライアント
│ └── tools.py # MCPツール定義
├── .claude/skills/
│ └── subscription-analyzer/ # サブスク分析Skill
│ ├── SKILL.md
│ └── patterns.yml
└── tests/
└── test_integration.py使用例
口座明細の取得（サブスク分析に便利）
Claude: freeeの口座明細を取得して、サブスクリプションを確認して→ list_wallet_txns で明細テキスト（例: "ANTHROPIC_カード13"）を含む明細を取得
財務諸表の確認
Claude: 2024年度の損益計算書を見せて→ get_trial_balance_pl で損益計算書を取得
取引の作成
Claude: 今日付けで外注費30,000円の取引を作成して→ create_deal で取引を自動作成
技術仕様
token暗号化
暗号化方式: Fernet（symmetric encryption）
保存場所:
~/.freee-mcp/tokens.encキー管理: 環境変数
TOKEN_ENCRYPTION_KEY（32 bytes）
エラーハンドリング
401 Unauthorized: 自動リフレッシュ → 再実行
429 Too Many Requests: 指数バックオフ（2^n秒）
500 Server Error: 3回リトライ
ライセンス
MIT License - 詳細は LICENSE を参照
貢献
Issue・Pull Request歓迎です。
関連リンク
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.