What it does

freee-mcp exposes the freee platform's accounting, HR/personnel, invoicing, time tracking, sales, IT management, and e-contract APIs to Claude and other AI agents. The server handles OAuth 2.0 authentication with PKCE, request validation against OpenAPI schemas, and API routing. Paired with freee Agent Skills (a separate reference package), it enables agents to query transaction lists, create invoices from templates, manage employee records, file expense reports, and automate contract workflows. Two deployment paths are available: a remote MCP hosted by freee (minimal setup) or a local MCP server for self-managed authentication.

Who it's for

Japanese companies and teams using freee for accounting, payroll, invoicing, or contracts who want to automate operations via AI agents. Developers building business automation tools that integrate with Japanese accounting or HR systems.

Common use cases

Query transaction lists and account data from Claude to prepare reports or audit trails
Create and manage invoices, purchase orders, and delivery notes by referencing prior documents
Retrieve and update employee records, attendance logs, and payroll information
File and track expense reports with consistent account codes and department tagging
Automate e-contract document management and signing workflows

Setup pitfalls

Secrets found in repository: the server stores OAuth tokens and credentials locally; keep .env and state files out of version control and secured.
OAuth callback URL must be exactly http://127.0.0.1:54321/callback when registering a freee app; mismatches will fail authentication.
Agent Skills are installed separately: the MCP server provides API calls, but the Agent Skills package (.zip) provides API reference and operation recipes; both are required for effective use.
CI suite not currently passing; review recent commits before upgrading to a new version.