home / mcp / freee mcp server

Freee MCP Server

Provides an MCP server that exposes freee API calls for Claude with OAuth 2.0 PKCE and multi-company support

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "him0-freee-mcp": {
      "command": "npx",
      "args": [
        "@him0/freee-mcp"
      ],
      "env": {
        "FREEE_CLIENT_ID": "YOUR_CLIENT_ID",
        "FREEE_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

You run a local MCP server that exposes freee API calls to Claude through a dedicated skill, enabling you to fetch accounting, HR, invoicing, time tracking, and sales data securely with OAuth 2.0. This setup streamlines how Claude accesses freee data by combining a server that handles API calls with a skill that provides a structured API reference.

How to use

You first install and configure the MCP server, then connect Claude Desktop to start issuing requests like retrieving deals or creating invoices. The server validates requests, handles authentication, and forwards calls to the freee API, returning responses that Claude formats for you.

How to install

Prerequisites you need before starting are Node.js and npm or an equivalent package manager that can run npx. You also need a freee developer account to obtain API credentials.

Step 1. Install and configure the MCP server locally by running the interactive setup command.

npx @him0/freee-mcp configure

Step 2. During setup you will provide OAuth credentials and select the freee account context. You can access the current company and switch contexts as needed.

Add MCP server to Claude Desktop configuration

After configuration, add the MCP server to Claude Desktop so it can invoke the local MCP process.

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

Connecting Claude to the local MCP server

In Claude Desktop, ensure the new MCP server entry is active. Claude Code will fetch API reference data from the Skill and use the MCP tool to call the local server.

Additional setup and notes

Environment variables are supported for credentials during initial setup, but placing sensitive values in environment variables is discouraged for ongoing use. Prefer running the interactive configuration to populate the required configuration file.

Claude Plugin and API references

Install the Claude plugin to access API-reference-enhanced skills. This provides accurate API details for the Freee MCP endpoints across five areas: Accounting, HR & Payroll, Invoices, Time Tracking, and Sales.

Developer tools and commands

Use the following tools to manage authentication, context, and API calls.

Available tools

freee_authenticate

Initiates OAuth authentication with the freee API to obtain access and refresh tokens.

freee_auth_status

Checks whether your OAuth tokens are still valid and not expired.

freee_clear_auth

Clears stored authentication tokens and resets the auth state.

freee_set_current_company

Switches the active freee company (office) context for subsequent API calls.

freee_get_current_company

Returns the currently selected company context.

freee_list_companies

Retrieves a list of all available companies you can switch between.

freee_current_user

Fetches information about the currently authenticated user.

freee_api_get

Issues a GET request to a Freee API endpoint and returns the response.

freee_api_post

Issues a POST request to a Freee API endpoint and returns the response.

freee_api_put

Issues a PUT request to a Freee API endpoint and returns the response.

freee_api_delete

Issues a DELETE request to a Freee API endpoint and returns the response.

freee_api_patch

Issues a PATCH request to a Freee API endpoint and returns the response.

freee_api_list_paths

Lists available API paths defined in the OpenAPI schema for quick reference.