# Freee CLI Skill

> freee CLI (`freee`) を使って freee API を操作する。 会計・人事労務・請求書・工数管理・販売の API リファレンスと使い方ガイドを提供。 経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理など、 freee関連の操作やAPI仕様を調べたいときに使う。

- Skill: `hchonan/freee-cli-skill` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add hchonan/freee-cli-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hchonan/freee-cli-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: hchonan (https://skillmd.com/u/hchonan)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/hchonan/freee-cli-skill

---


# freee CLI

## Look things up before answering

CLI is self-documenting. Always run these instead of guessing:

- `freee accounting ls [filter]` -- list endpoints (filter by keyword).
- `freee accounting get <path> --help` -- show params for GET.
- `freee accounting post <path> --help` -- show params/body for POST.
- `freee accounting <path> --help` -- list available methods.

## Install

If `freee` command is not found, ask the user to install the Go binary from this repository's GitHub Releases or build it with `go build -o freee .`.

## Authentication

`freee auth login` to authenticate (opens browser).
For remote shells, use `freee auth login --remote` or `freee configure --remote` and set up port forwarding first:
`ssh -L 54321:127.0.0.1:54321 <user>@<remote-host>`.
Use `--no-open` when the CLI should print the auth URL without opening a browser.
Tokens are auto-refreshed. If 401 error occurs, run `freee auth login` again.

## API Calls

```bash
freee accounting get deals limit==10
freee accounting post deals -d '{"type":"income","issue_date":"2025-01-15","details":[{"tax_code":1,"amount":10000}]}'
freee accounting post deals -d @body.json
cat body.json | freee accounting post deals -d -
freee accounting delete deals/123
```

service: accounting, hr, invoice, pm, sm
path: shorthand OK (`deals` = `/api/1/deals`)

## Recipes

- `recipes/deal-operations.md` -- 取引
- `recipes/expense-application-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/sm-operations.md` -- 販売管理
- `recipes/troubleshooting.md` -- トラブルシューティング