freee-mcp

Установка

Работает в

• Claude Code
• Claude Desktop
• Codex
• Cursor
• OpenCode
• GitHub Copilot
• Gemini CLI
• SourceCraft
• Koda
• Coddy

Ручная установка

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

Что делает

freee-mcp дает агенту работать с данными freee, японской облачной системы для бизнеса. Сервер вызывает API, проверяет запросы по схемам OpenAPI и сам обновляет токены OAuth 2.0 с PKCE. Поддерживаются 12 API: бухгалтерия, кадры и зарплата, счета, учет трудозатрат, продажи, управление ИТ-активами, основные средства, подрядчики, опросы, открытие бизнеса, оценка персонала и налоговые декларации. Ссылаться на конкретную компанию из нескольких можно и переключать ее на ходу. Инструменты устроены просто: по одному на каждый метод HTTP (freee_api_get, `post`, `put`, `patch`, `delete`) и freee_api_list_paths для списка путей. Рядом идут служебные команды вроде freee_authenticate, freee_list_companies и freee_set_current_company. Электронные договоры freee Sign обслуживает отдельная команда `freee-sign-mcp`. Вместе с сервером поставляется скилл freee-api-skill. Он подгружает в контекст справочник по нужному API и рецепты: как оформить сделку, расходную заявку, счет, табель, как работать с основными средствами и декларацией. Так агент получает точные пути и параметры и не переполняет контекст. Просьбу вроде «создай счет этому клиенту по прошлому месяцу» агент выполняет, сверяясь с прежними документами.

Для кого. Для бухгалтеров, финансистов и HR-специалистов, которые ведут учет в freee и хотят управлять им из Claude, Claude Code, Cursor или Codex.

Пример запроса к агенту

Посмотри в freee счет, который мы выставляли компании ABC в прошлом месяце, и создай такой же на этот месяц

MCP

Транспорт

stdio, http

Авторизация

OAuth

Ограничения

Нужна учетная запись freee. Модули опросов, открытия бизнеса и оценки персонала доступны только в удаленной версии, а налоговые декларации требуют подходящего окружения, клиента OAuth, тарифа и прав пользователя. Удаленный MCP для freee Sign не готов, подписи работают только через локальную команду `freee-sign-mcp`. Для локального запуска приложение надо зарегистрировать в магазине приложений freee с `callback`-адресом http://127.0.0.1:54321/callback. Если в запросе есть company_id, он должен совпадать с текущей компанией, иначе сервер вернет ошибку. Документация на японском, сервис ориентирован на японских компаний.

Как отключить. В Claude и Claude Desktop удалите пользовательский коннектор freee, а в конфигурации MCP уберите блок freee. Для плагина Claude Code выполните /plugin `uninstall` freee-mcp@freee-mcp-marketplace. Отозвать доступ можно и в настройках приложения в магазине freee. Локальные данные авторизации сбрасывает инструмент freee_clear_auth.

Коротко о README

README на японском представляет официальный сервер freee и скиллы как пару: сервер отвечает за вызовы, аутентификацию и проверку запросов, скилл за справочники и рецепты. Описаны два способа запуска (удаленный и локальный), установка скилла через архив, npx skills, gh skill и APM, плагины для Claude Code и Codex, таблица содержимого скиллов по API, советы по повторяющимся данным и перечень инструментов. Отдельный раздел посвящен подписи freee Sign.