freee MCP Server

Content

freee MCP Server is freee's official MCP integration for AI agents. It connects Claude and other MCP clients to freee accounting, HR, invoices, project time, sales, IT management, and freee Sign APIs through schema-validated API tools and OAuth-backed authentication.

Use it when a business workflow needs Claude to inspect or operate on freee data with the official Remote MCP endpoint or a local npm server. Pair it with the bundled freee API skill references when the assistant needs endpoint details, parameter guidance, recipes, or troubleshooting notes.

Source Review

• https://github.com/freee/freee-mcp
• https://raw.githubusercontent.com/freee/freee-mcp/main/README.md
• https://registry.npmjs.org/freee-mcp
• https://raw.githubusercontent.com/freee/freee-mcp/main/LICENSE
• https://raw.githubusercontent.com/freee/freee-mcp/main/package.json
• https://raw.githubusercontent.com/freee/freee-mcp/main/mcp.json
• https://raw.githubusercontent.com/freee/freee-mcp/main/src/mcp/tools.ts
• https://raw.githubusercontent.com/freee/freee-mcp/main/src/api/client.ts
• https://raw.githubusercontent.com/freee/freee-mcp/main/src/auth/oauth.ts
• https://raw.githubusercontent.com/freee/freee-mcp/main/skills/freee-api-skill/SKILL.md

These sources were reviewed on 2026-06-06. Prefer the live repository, README, npm metadata, license, package metadata, MCP config, MCP tool registration, API client, OAuth implementation, and bundled skill metadata for current setup and operating details.

Features

• Connect to freee's official Remote MCP endpoint.
• Run a local stdio server through the freee-mcp npm package.
• Use OAuth 2.0 with PKCE and automatic token refresh.
• Inspect authentication status and clear local authentication.
• List companies, switch the active company, and retrieve the current user.
• Call schema-validated freee API paths through GET, POST, PUT, PATCH, and DELETE tools.
• List available API paths for supported services.
• Upload files for supported local-mode workflows.
• Work with freee accounting data such as deals, journals, invoices, receipts, payments, transfers, taxes, partners, sections, and reports.
• Work with freee HR records such as employees, attendance, payroll statements, paid leave, overtime, and year-end adjustment references.
• Work with invoice, project management, sales management, IT management, and freee Sign references through the bundled skill content.
• Use company ID consistency checks to reduce cross-company request mistakes.

Installation

For the official Remote MCP path, add the freee endpoint in clients that support remote MCP connectors:

{
  "mcpServers": {
    "freee": {
      "url": "https://mcp.freee.co.jp/mcp"
    }
  }
}

For local setup, configure OAuth and the selected company:

npx freee-mcp configure

Then add the local server:

{
  "mcpServers": {
    "freee": {
      "command": "npx",
      "args": ["freee-mcp"]
    }
  }
}

freee Sign uses its own local command:

{
  "mcpServers": {
    "freee-sign": {
      "command": "npx",
      "args": ["--package=freee-mcp", "--", "freee-sign-mcp"]
    }
  }
}

Use Cases

• Retrieve and summarize accounting transactions, invoices, receipts, and trial balance data.
• Create or update invoices, expense applications, deals, payment requests, or manual journals after explicit user confirmation.
• Review HR attendance, employee, payroll, and leave data for an authorized company.
• Inspect project workloads, sales orders, IT assets, SaaS account records, or freee Sign document metadata.
• Use bundled recipes and references to choose API paths and parameters before executing a business operation.
• Check the active company and current user before running company-scoped API calls.

Safety and Privacy

freee MCP can operate on sensitive business systems. Treat every write or delete operation as a real accounting, HR, sales, IT, or e-signature action. Confirm the active company, service, API path, request body, and intended side effects before allowing POST, PUT, PATCH, DELETE, file upload, or e-signature calls.

The data surface includes financial transactions, invoices, payroll, employees, attendance, customer and partner records, receipts, projects, IT assets, and legal documents. Keep OAuth tokens and client secrets private, avoid unofficial Remote MCP endpoints, and assume API responses can enter the MCP client and model context.

Duplicate Notes

Existing catalog entries cover billing, payments, and finance tools. This entry covers the official freee/freee-mcp repository and freee-mcp package for freee's accounting, HR, invoice, project, sales, IT management, and freee Sign API workflows.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationraw.githubusercontent.com
• Submitted by oktofeesh12026-06-06