SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsfreee-api-skill

freee-api-skill

Coding & development

View repository

Updated 10-15 20:04

About this skill

freee API Skill

Overview

freee-mcp (MCP server) to integrate with the freee API.

Role of this skill:

  • Provide detailed references for the freee API
  • Provide a freee-mcp usage guide and API call examples

Note: OAuth authentication must be performed by the user in their own environment.

Setup

1. OAuth authentication (run in your terminal)

npx freee-mcp configure

Log in to freee in your browser and select a company. The settings are saved to ~/.config/freee-mcp/config.json .

2. Restart and verify

After restarting Claude, check the authentication status with thefreee_auth_status tool.

Reference

API references are included in references/ . Each reference contains detailed information on parameters, request bodies, and responses.

To find the API you want,references/ search the files in the directory by keyword.

Main references:

  • accounting-deals.md - Deals
  • accounting-expense-applications.md - Expense applications
  • hr-employees.md - Employee information
  • hr-attendances.md - Attendance
  • invoice-invoices.md - Invoices

Usage

MCP tools

Authentication and company management:

  • freee_authenticate - OAuth authentication
  • freee_auth_status - Check authentication status
  • freee_clear_auth - Clear authentication information
  • freee_current_user - Get logged-in user information
  • freee_list_companies - List companies
  • freee_set_current_company - Switch company
  • freee_get_current_company - Get current company

File operations:

  • freee_file_upload - Upload a file to the file box (POST /api/1/receipts)

API calls:

  • freee_api_get - GET request
  • freee_api_post - POST request
  • freee_api_put - PUT request
  • freee_api_delete - DELETE request
  • freee_api_patch - PATCH request
  • freee_api_list_paths - List of available API paths

service parameter (required):

service Description Path example
accounting freee Accounting (deals, account items, partners, etc.) /api/1/deals
hr freee HR & Labor (employees, attendance, etc.) /api/v1/employees
invoice freee Invoicing (invoices, quotes, delivery notes) /invoices
pm freee Time Tracking (projects, time tracking, etc.) /projects
sm freee Sales (quotes, orders, sales, etc.) /businesses

Basic workflow

  1. Check the company: freee_get_current_company to get the current company ID (required the first time. Once obtained within a session, it can be reused thereafter)
  2. Check the recipe: recipes/ Read the relevant recipe in
  3. Search the reference: As needed, references/ refer to
  4. Call the API: freee_api_* Use the tool (for endpoints that require company_id, use the value obtained in step 1)

Note:

  • company_id must match the currently configured company. If they do not match, an error will occur
  • To change the company: first freee_set_current_company switch with , then execute the request

Recipes

See below for use case samples and tips for common operations:

  • recipes/expense-application-operations.md - Expense applications
  • recipes/deal-operations.md - Transactions (income and expenses)
  • recipes/hr-employee-operations.md - HR and labor (employees and payroll)
  • recipes/hr-attendance-operations.md - Attendance (clock-in/clock-out, time clocking, break registration)
  • recipes/invoice-operations.md - Invoices, quotes, and delivery notes
  • recipes/receipt-operations.md - File Box (uploading and managing evidence files)
  • recipes/pm-operations.md - Labor cost management (projects and labor cost actuals)
  • recipes/pm-workload-registration.md - Safe registration of labor costs (PM/HR integration workflow)
  • recipes/sm-operations.md - Sales management (deals and orders)

Error handling

  • Authentication error: freee_auth_status check with → freee_clear_auth → freee_authenticate
  • Company error: freee_list_companies → freee_set_current_company
  • Details: recipes/troubleshooting.md see

About API feature limitations

Problems caused by feature limitations of the freee API itself cannot be resolved with freee-mcp. For details, see recipes/troubleshooting.md .

Related links