Happy slice of mcp pizzaMCP.pizza

freee-mcp

MCP.Pizza Chef: freee

This is freee's own official connector for their Japanese business software, covering bookkeeping, staff and payroll records, invoices, timesheets, sales, company device management and electronic contracts. You can pull up past transactions, raise this month's invoice modelled on last month's, or check where an expense claim has got to, without opening the website. The gentlest route is freee's hosted connection: add a custom connector in Claude pointing at their address and sign in. A local install is available too. You need a freee account.

Data
Other

Use This MCP server To

Look up last month's transactions for one client Create this month's invoice modelled on the last one Check which expense claims are still waiting for approval Pull up an employee's payroll details Switch between the businesses I manage Find a contract that still needs signing

README

freee-mcp

freee会計、人事労務、請求書、工数管理、販売、IT管理、サイン（電子契約）を AI Agent から操作できるようにする freee 公式の MCP サーバーと Agent Skills です。

  • MCP サーバー: freee API の呼び出し・認証・リクエスト検証を担当
  • Agent Skills: API リファレンスと操作レシピを AI Agent のコンテキストに注入し、正確な API 利用をガイド

npm version

特徴

  • 複数 API 対応: 会計・人事労務・請求書・工数管理・販売・IT管理の6つの freee API をサポート
  • サイン（電子契約）対応: freee サインの文書管理 API を専用コマンド（freee-sign-mcp）でサポート
  • OAuth 2.0 + PKCE: セキュアな認証フロー、トークン自動更新
  • 複数事業所対応: 事業所の動的切り替えが可能

Agent Skills と MCP の通信の流れ

Agent Skills（API リファレンス・操作レシピ）と MCP サーバー（API 呼び出し）を組み合わせて利用します。

sequenceDiagram
    participant User as ユーザー
    participant Agent as AI Agent
    participant Skill as Agent Skills<br/>(API リファレンス・操作レシピ)
    participant MCP as MCP サーバー
    participant API as freee API

    User->>Agent: リクエスト<br/>「取引一覧を取得して」

    Note over Agent,Skill: 1. Agent Skills からリファレンスを取得
    Agent->>Skill: freee-api-skill 呼び出し
    Skill-->>Agent: API リファレンス注入<br/>(エンドポイント、パラメータ仕様)

    Note over Agent,MCP: 2. MCP Tool で API を実行
    Agent->>MCP: freee_api_get 呼び出し<br/>path: /api/1/deals
    MCP->>MCP: OpenAPI スキーマで検証
    MCP->>MCP: 認証トークン付与

    Note over MCP,API: 3. freee API への通信
    MCP->>API: GET /api/1/deals<br/>Authorization: Bearer xxx
    API-->>MCP: JSON レスポンス

    MCP-->>Agent: 取引データ
    Agent-->>User: 結果を整形して表示
Loading

この仕組みにより：

  • Agent Skills: 必要な API リファレンスや操作レシピを段階的にコンテキストに注入（コンテキスト効率化）
  • MCP: 認証・リクエスト検証・API 呼び出しを担当

freee-mcp FAQ

Is this official, and still maintained?
Yes on both counts. It is published by freee themselves and was updated within the last few days.
Do I need a freee account?
Yes. It works with the freee services your business already subscribes to, and you sign in with your usual account.
How hard is setup?
At its easiest, one step. In Claude you add a custom connector pointing at freee's hosted address and sign in, with no files to edit. Running it on your own machine takes a guided setup wizard instead.
Which apps does it work in?
Claude and Claude Desktop through a custom connector, plus Claude Code, Cursor, Codex and other coding assistants through their plugin systems.
Can I use this to raise an invoice?
Yes. A good trick is asking it to copy the shape of a previous invoice so the client, line items and tax treatment come out consistent.
Is it in English?
The setup documentation is written in Japanese and freee serves businesses operating in Japan, so expect Japanese labels throughout.
Does the hosted version cover everything?
Not quite. The electronic contract side, freee Sign, currently runs only from a local install.