广告合作
MCP.so
登录

Freee MCP Solo

@kogasura

代码仓库

基本信息

分类

金融与商务

许可证

MIT

传输方式

stdio

作者

kogasura

提交者

yuuki okubo

关于 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

Freee MCP Solo 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Freee MCP Solo 工具

6

OAuth認証の開始・状態確認。初回認証やトークン失効時に使用。

未処理（未仕訳）の口座明細一覧を取得する。口座名や期間で絞込可能。

取引（仕訳）を登録する。勘定科目は名前で指定。税区分は勘定科目のデフォルトを自動適用。口座指定で明細と自動紐付け。

月次の収支サマリーを勘定科目別に集計して表示する。

請求書を作成する（下書き）。取引先名で指定。入金期日は設定ファイルのルールから自動計算。明細は複数行対応。

請求書の一覧を取得する。取引先名で絞込可能。

概览

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.

常见问题

1

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.

2

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.

3

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.

4

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.

5

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.

评论

金融与商务 分类下的更多 MCP 服务器

BackPow PoW Oracle MCP Server

BackpowCom

Live Proof-of-Work mining data for AI agents: difficulty, hashrate, solo-mining odds, cost of production and hardware profitability for 126+ networks and 770+ ASIC/GPU/CPU models. Read-only, no API key.

1

Dados B3

Valth Guimarães

Auditable fundamentals for the Brazilian stock market (B3): ROIC, margins, point-in-time multiples, dividends and REITs. Every figure traces back to the CVM account it came from, every formula is published, and nothing s

DeFi Quant Multi-Protocol Yield & Risk API

Pyrochem

Model Context Protocol (MCP) server for 6-protocol DeFi quantitative telemetry, stablecoin carry radar, and risk simulation.

1

Backlane

Backlane

Hosted MCP server for eCommerce. Connects your OTTO Market, Kaufland and 50+ Mirakl marketplace seller accounts (home24, Decathlon, XXXLutz, MediaMarktSaturn and more) to Claude, ChatGPT, Cursor and VS Code: check stock

FiatDock

fiatdock

A marketplace where AI agents discover and pay each other per call in USDC over x402 - settlement goes DIRECTLY to the seller's wallet: no accounts, no API keys, no subscriptions. Buy from the live catalog, or list your

1
广告合作