Summary

This project provides a Model Context Protocol (MCP) server and Claude Plugin to enable direct integration of freee's business APIs (Accounting, HR, Invoicing, etc.) with AI models like Claude. It targets developers and power users seeking to automate workflows by connecting freee's services to AI agents, offering a streamlined and secure way to access financial and operational data.

How It Works

The architecture separates API reference management (SKILL) from API execution (MCP Server). Claude Code first queries the SKILL for relevant API documentation (endpoints, parameters) and then uses the MCP server to perform the actual API calls. The MCP server validates requests against OpenAPI schemas, handles secure OAuth 2.0 + PKCE authentication with automatic token renewal, and communicates with the freee APIs. This approach optimizes Claude's context usage by injecting API references dynamically and centralizes complex authentication and validation logic.

Quick Start & Requirements

• Installation: Requires Node.js and pnpm. Users must register a freee application to obtain Client ID/Secret and set the callback URL to http://127.0.0.1:54321/callback. Configuration is handled interactively via npx freee-mcp configure, which guides through authentication and company selection. The output is added to Claude Desktop's claude_desktop_config.json. The plugin is installed using npx skills add freee/freee-mcp.
• Links: Official quick-start is via the npx commands and configuration file editing.

Highlighted Details

• Supports five core freee API suites: Accounting, HR & Payroll, Invoicing, Time Tracking, and Sales.
• Features robust OAuth 2.0 + PKCE authentication with automatic token refresh capabilities.
• Enables dynamic switching and management of multiple freee business accounts (事業所).
• API request validation is performed against OpenAPI schemas for data integrity.

Maintenance & Community

The project employs an AI-driven development flow, prioritizing code consistency. Contributions are managed through GitHub Issues rather than direct Pull Requests; maintainers will implement proposed changes. Community interaction, questions, and information exchange occur on a dedicated Discord server.

Licensing & Compatibility

The project is licensed under the Apache-2.0 license, which permits commercial use and integration into proprietary software.

Limitations & Caveats

This project is currently under active development and may exhibit unexpected behavior or bugs. Direct Pull Requests are not accepted; all proposed changes must be submitted as Issues for maintainer review and implementation.