Freee
An MCP server and Claude plugin that enables interaction with freee APIs for accounting, human resources, invoicing, and more. It provides secure OAuth 2.0 authentication and integrates detailed API reference skills to support tasks like creating inv
What is Freee?
Freee is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server and claude plugin that enables interaction with freee apis for accounting, human resources, invoicing, and more. it provides secure oauth 2.0 authentication and integrates detailed api refe...
An MCP server and Claude plugin that enables interaction with freee APIs for accounting, human resources, invoicing, and more. It provides secure OAuth 2.0 authentication and integrates detailed API reference skills to support tasks like creating inv
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server and Claude plugin that enables interaction wit
Use Cases
Maintainer
Works with
Installation
NPM
npx -y freee-mcpManual Installation
npx -y freee-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Freee
The freee MCP server connects AI assistants to freee's Japanese business software suite, enabling operations across accounting, HR and payroll, invoicing, time tracking, sales management, and electronic contracts through natural language. It authenticates via OAuth 2.0 and exposes generic REST tools (freee_api_get, freee_api_post, freee_api_put, freee_api_delete, freee_api_patch) that cover over 80 freee API operations, as well as a freee Sign integration for electronic contracts. Businesses using freee can automate bookkeeping, invoice creation, and HR tasks directly from Claude.
Prerequisites
- A freee business account (freee.co.jp)
- A freee developer app registration to get a Client ID and Client Secret (from the freee developer portal)
- Node.js 18 or later with npx available
- Claude Desktop or another MCP-compatible client
Register a freee developer application
Log in to the freee developer portal (developer.freee.co.jp) and create a new application. Set the callback URL to http://127.0.0.1:54321/callback. Save the Client ID and Client Secret.
Run the configuration wizard
Run the freee-mcp configure command, which launches an interactive wizard that prompts for your Client ID and Client Secret and saves OAuth credentials locally.
npx freee-mcp configureAdd the server to Claude Desktop config
Add the freee server block to claude_desktop_config.json. The server will use the OAuth credentials saved during configuration.
{
"mcpServers": {
"freee": {
"command": "npx",
"args": ["freee-mcp"]
}
}
}Alternatively, use the remote MCP endpoint
Claude Desktop supports adding freee as a custom remote connector. Add the freee remote MCP URL as a custom integration in Claude Desktop settings — no local installation needed.
https://mcp.freee.co.jp/mcpAuthorize via OAuth
On first use, Claude will trigger the OAuth flow. A browser window opens for you to log in to freee and grant the application permission to access your company data.
(Optional) Configure freee Sign for electronic contracts
If you need the electronic signature integration, run a separate configure step for freee-sign-mcp and add it as a second server entry.
npx --package=freee-mcp -- freee-sign-mcp configureFreee Examples
Client configuration
Local Claude Desktop setup using npx. OAuth credentials are stored after running npx freee-mcp configure.
{
"mcpServers": {
"freee": {
"command": "npx",
"args": ["freee-mcp"]
}
}
}Prompts to try
Example requests for freee accounting, HR, invoicing, and time tracking operations.
- "Create an invoice for Acme Corp based on last month's invoice as a template"
- "List all unpaid invoices from the past 90 days"
- "Submit an expense report for a business trip: 15,000 yen for transportation, account code 5200"
- "Show me the payroll summary for employees in the Tokyo office for last month"
- "Log 8 hours of work on the product development project for today"
- "Get the current balance of the main bank account in the accounting system"Troubleshooting Freee
OAuth flow fails or callback URL is rejected
Ensure the callback URL in your freee developer app settings is exactly http://127.0.0.1:54321/callback. Port 54321 must be free on localhost when you run the OAuth flow. Re-run npx freee-mcp configure if credentials are stale.
API calls return 403 Forbidden
Your freee OAuth app may not have the required permission scopes for the operation. Check the app's permissions in the freee developer portal and ensure the scopes cover accounting, HR, or invoicing as needed. Re-authorize after updating scopes.
npx freee-mcp fails with package not found
The package name on npm is freee-mcp (not @him0/freee-mcp). Run npx freee-mcp configure directly in a terminal to confirm it resolves correctly. Ensure you have Node.js 18+ and a working internet connection.
Frequently Asked Questions about Freee
What is Freee?
Freee is a Model Context Protocol (MCP) server that mcp server and claude plugin that enables interaction with freee apis for accounting, human resources, invoicing, and more. it provides secure oauth 2.0 authentication and integrates detailed api reference skills to support tasks like creating inv It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Freee?
Install via npm with the command: npx -y freee-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Freee?
Freee works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Freee free to use?
Yes, Freee is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Freee Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Freee? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Freee in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Freee?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.