Freee Mcp Solo

Name: Freee Mcp Solo
Author: kogasura

@kogasura

Repository

About Freee Mcp Solo

A use-case driven MCP server for freee accounting, designed for sole proprietors in Japan.

#freee #accounting #invoice #sole-proprietor #freelancer #japan

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Freee Mcp Solo?

An MCP (Model Context Protocol) server specialized for freee Accounting, designed for sole proprietors and freelancers to handle daily bookkeeping tasks. It allows Claude Code or Claude Desktop to execute journal entries, invoice creation, and monthly summaries via simple tool calls.

How to use Freee Mcp Solo?

Install globally with npm install -g freee-mcp-solo, create a configuration file at ~/.config/freee-mcp-solo/config.yaml with freee developer credentials, and register the server in your MCP client (Claude Code or Claude Desktop) by adding the command to the appropriate config file. After setup, run the authenticate tool to obtain OAuth tokens.

Key features of Freee Mcp Solo

Use-case driven: optimized for actual accounting workflows, not a raw API wrapper.
Name-based operations: specify accounts, partners, and banks by name.
Flexible YAML configuration for payment details, due date rules, and subject templates.
Automatic full-width/half-width normalization for matching bank names.

Use cases of Freee Mcp Solo

Registering unreconciled bank transactions as journal entries.
Creating draft invoices with automatic due dates and subject templates.
Viewing monthly income/expense summaries by account category.
Listing pending transactions and invoices via Claude prompts.

FAQ from Freee Mcp Solo

What are the prerequisites for using Freee Mcp Solo?

Node.js 20 or higher, a freee Accounting account (Personal Business Plan or above), and a freee developer app’s Client ID and Client Secret obtained from the freee developer portal.

How do I set up the configuration file?

Create ~/.config/freee-mcp-solo/config.yaml from the provided example and fill in your freee app credentials, bank information, invoice defaults, and partner-specific settings like due date rules and subject templates.

What tools does Freee Mcp Solo provide?

It offers authenticate, pending_transactions, create_deal, monthly_summary, create_invoice, and list_invoices tools for handling OAuth, transaction entry, monthly reports, and invoice management.

How does the server handle authentication?

On first use, running the authenticate tool opens a browser window for freee login and authorization. OAuth tokens are saved locally, and the company ID/name are automatically written to the config file.

Which freee APIs does the server use?

The server uses freee’s Accounting API (https://api.freee.co.jp/api/1/) for journal entries, account details, and master data, and the Invoice API (https://api.freee.co.jp/iv/) for invoice creation and listing.

Comments

More Finance & Commerce MCP servers

Armor Crypto MCP

armorwallet

The MCP server for interacting with Blockchain, Swaps, Strategic Planning and more.

181

kospi-kosdaq-stock-server

dragon1086

An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP

Polygon.io MCP Server

polygon-io

An MCP server for Massive.com Financial Market Data

364

Financial Modeling Prep MCP (Model Context Protocol)

imbenrabi

A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.

139

中国股票数据

elsejj

这是一个为大模型提供 A 股数据的的 MCP(Model Content Protocol) 服务。

459