freee-mcp (MCP サーバー) を通じて freee API と連携。
Works with
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versionfreee-api-skillExecute the skills CLI command in your project's root directory to begin installation:
Fetches freee-api-skill from him0/freee-mcp and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate freee-api-skill. Access via /freee-api-skill in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Automate repetitive workflows and reduce manual effort
Example
Generate reports, summarize documents, draft communications
Save 3-5 hours per week on routine tasks
Learn new skills, understand complex topics, get expert guidance
Example
Explain concepts, provide examples, suggest learning resources
Accelerate learning and skill development by 2x
Enhance output quality through reviews, suggestions, and refinements
Example
Review drafts, suggest improvements, catch errors
Improve work quality by 30-40% with less effort
0
total installs
0
this week
396
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
396
stars
freee-mcp (MCP サーバー) を通じて freee API と連携。
このスキルの役割:
接続方法は Remote MCP(推奨)とローカルの2つがあります。現在の接続モードは freee_server_info の transport フィールド(remote または stdio)で確認できます。
freee が提供する Remote MCP サーバーに接続する方法です。ローカルでのセットアップが不要で、すぐに利用を開始できます。
Claude 及び Claude Desktop では「カスタマイズ」より「カスタムコネクタを追加」を開き、以下を設定してください。
freeehttps://mcp.freee.co.jp/mcp初回接続時にブラウザで freee への認証が自動的に行われます。npx freee-mcp configure の実行は不要です。
その他の AI ツールでは、それぞれの案内に従って Remote MCP サーバーを追加してください。
freee アプリケーションを自分で登録し、ローカルで MCP サーバーを起動する方法です。
npx freee-mcp configure
ブラウザで freee にログインし、事業所を選択します。設定は ~/.config/freee-mcp/config.json に保存されます。
Claude を再起動後、freee_auth_status ツールで認証状態を確認。
API リファレンスが references/ に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの詳細情報があります。
目的のAPIを探すには、references/ ディレクトリ内のファイルをキーワード検索してください。
主なリファレンス:
accounting-deals.md - 取引accounting-expense-applications.md - 経費申請hr-employees.md - 従業員情報hr-attendances.md - 勤怠invoice-invoices.md - 請求書認証・事業所管理:
freee_authenticate - OAuth 認証(Remote MCP では認証は自動処理されるため通常は不要)freee_auth_status - 認証状態確認freee_clear_auth - 認証情報クリア(ローカルモード用)freee_current_user - ログインユーザー情報取得freee_list_companies - 事業所一覧freee_set_current_company - 事業所切り替えfreee_get_current_company - 現在の事業所取得サーバー情報:
freee_server_info - サーバー情報取得(バージョン、transport: remote/stdio)ファイル操作:
freee_file_upload - ファイルボックスにファイルをアップロード (POST /api/1/receipts) ※ローカルモードのみAPI 呼び出し:
freee_api_get - GET リクエストfreee_api_post - POST リクエストfreee_api_put - PUT リクエストfreee_api_delete - DELETE リクエストfreee_api_patch - PATCH リクエストfreee_api_list_paths - 利用可能なAPIパス一覧serviceパラメータ (必須):
| service | 説明 | パス例 |
|---|---|---|
accounting |
freee会計 (取引、勘定科目、取引先など) | /api/1/deals |
hr |
freee人事労務 (従業員、勤怠など) | /api/v1/employees |
invoice |
freee請求書 (請求書、見積書、納品書) | /invoices |
pm |
freee工数管理 (プロジェクト、工数など) | /projects |
sm |
freee販売 (見積、受注、売上など) | /businesses |
接続モードが不明な場合は freee_server_info で確認できます(transport が remote なら Remote MCP、stdio ならローカル)。Remote MCP の場合、認証は自動処理されるため手順1から開始できます。ローカルモードで未認証の場合は先に freee_authenticate を実行してください。
freee_get_current_company で現在の事業所IDを取得する(初回は必須。セッション内で1回取得すれば以降は使い回せる)recipes/ 内の該当レシピを読むreferences/ を参照freee_api_* ツールを使用(company_id が必要なエンドポイントでは手順1で取得した値を使う)注意:
company_id は現在設定されている事業所と一致している必要がある。不一致の場合はエラーになるfreee_set_current_company で切り替えてからリクエストを実行よくある操作のユースケースサンプルとTipsは以下を参照:
recipes/expense-application-operations.md - 経費申請recipes/deal-operations.md - 取引(収入・支出)recipes/hr-employee-operations.md - 人事労務(従業員・給与)recipes/hr-attendance-operations.md - 勤怠(出退勤・打刻・休憩の登録)recipes/invoice-operations.md - 請求書・見積書・納品書recipes/receipt-operations.md - ファイルボックス(証憑ファイルのアップロード・管理)recipes/pm-operations.md - 工数管理(プロジェクト・工数実績)recipes/pm-workload-registration.md - 工数の安全な登録(PM・HR連携ワークフロー)recipes/sm-operations.md - 販売管理(案件・受注)VERSION.md を読んでスキルのバージョンを確認し、freee_server_info でサーバーバージョンを確認してください。スキルのバージョンがサーバーより古い場合、スキルの情報が最新のサーバーに対応していない可能性があります。スキルを最新版に更新してから再度お試しください。freee_auth_status で確認 → freee_clear_auth → freee_authenticatefreee_list_companies → freee_set_current_companyrecipes/troubleshooting.md 参照freee API 自体の機能制限に起因する問題は freee-mcp では解決できません。詳細は recipes/troubleshooting.md を参照してください。
https://mcp.freee.co.jp/mcpPrerequisites
Time Estimate
15-45 minutes depending on use case complexity
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.
✗ Avoid when
Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.
openai/skills
libtv-labs/libtv-skills
yejinlei/pdf-ocr-skill
jwynia/agent-skills
mindrally/skills
github/awesome-copilot
Registry listing for freee-api-skill matched our evaluation — installs cleanly and behaves as described in the markdown.
I recommend freee-api-skill for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
freee-api-skill reduced setup friction for our internal harness; good balance of opinion and flexibility.
Solid pick for teams standardizing on skills: freee-api-skill is focused, and the summary matches what you get after install.
freee-api-skill is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
We added freee-api-skill from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
freee-api-skill is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
freee-api-skill reduced setup friction for our internal harness; good balance of opinion and flexibility.
We added freee-api-skill from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
Solid pick for teams standardizing on skills: freee-api-skill is focused, and the summary matches what you get after install.
showing 1-10 of 28