Freee Mcp Solo

Name: Freee Mcp Solo
Author: kogasura

@kogasura

リポジトリ

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

基本情報

カテゴリ

金融とコマース

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

kogasura

投稿者

yuuki okubo

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.

「金融とコマース」の他のコンテンツ

Crypto Fear & Greed Index MCP Server

kukapay

Providing real-time and historical Crypto Fear & Greed Index data

Octagon: MCP for Market Data

OctagonAI

An MCP server for public & prediction markets research. Ask natural-language questions and get structured, source-backed answers across SEC filings, earnings transcripts, company financials, stock & crypto market data, and prediction markets news & research. Built for investors,

142