Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade freee con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Trabaja con freee Accounting (freee会計) y freee Invoice (freee請求書) desde cualquier agente de IA: operaciones con pagos, socios comerciales, cuentas contables, códigos de impuesto, artículos, departamentos y etiquetas, movimientos de banco y tarjeta, asientos manuales, el libro diario, balances de comprobación y el libro mayor, el archivo de justificantes y facturas y presupuestos. Inicio de sesión OAuth con tu propia app de freee; borrar operaciones y asientos viene desactivado al instalar.
Prueba a pedir
Prompts de ejemplo para freee
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → freee, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
freee + Meta Muse
Trabaja con freee Accounting (freee会計) y freee Invoice (freee請求書) desde cualquier agente de IA: operaciones con pagos, socios comerciales, cuentas contables, códigos de impuesto, artículos, departamentos y etiquetas, movimientos de banco y tarjeta, asientos manuales, el libro diario, balances de comprobación y el libro mayor, el archivo de justificantes y facturas y presupuestos. Inicio de sesión OAuth con tu propia app de freee; borrar operaciones y asientos viene desactivado al instalar.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
FREEE_CLIENT_ID, FREEE_CLIENT_SECRET
Paso 1 — Obtener credenciales
La configuración lleva unos 10 minutos. Necesitas una cuenta de freee con acceso a las empresas (事業所) con las que debe trabajar la IA. El conector usa la freee API (https://api.freee.co.jp): freee会計 en /api/1 y freee請求書 en /iv. Desde el cambio del sistema de facturación de octubre de 2023, las facturas y presupuestos se crean en freee請求書; los antiguos endpoints /api/1/invoices no se usan.
- Inicia sesión en https://app.secure.freee.co.jp/developers/applications (freee app store, 開発者向け) y haz clic en 新規追加 para crear una app. Una app privada (非公開アプリ) basta para tus propias empresas.
- En la pestaña 基本設定 añade la callback URL
<your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloudhttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - En 権限設定 marca lectura, y escritura para las herramientas de escritura que vayas a usar, en 会計 (取引, 取引先, 勘定科目, 品目, 部門, メモタグ, 税区分, 口座, 口座明細, 振替伝票, 仕訳帳, 試算表, ファイルボックス, 事業所, ユーザー) y 請求書 (請求書, 見積書). freee define los permisos en la app, no como scopes de OAuth. Haz clic en 保存.
- Pega el Client ID en
FREEE_CLIENT_IDy el Client Secret enFREEE_CLIENT_SECRET, dejaFREEE_REFRESH_TOKENvacío e instala. - En la página del conector haz clic en Authorize with Provider e inicia sesión en freee con un usuario que pueda ver las empresas que necesitas. freee te pide elegir una empresa (事業所選択) y muestra los permisos de la app.
- Ejecuta
freee_get_me: muestra el usuario y sus empresas con elcompany_idque necesitan las demás herramientas.
Los tokens de acceso duran 6 horas y se renuevan con el refresh token. freee emite un refresh token nuevo en cada renovación y el anterior deja de funcionar, así que un refresh token que también use otra herramienta ya no sirve aquí. Un refresh token sin usar durante 90 días caduca: entonces vuelve a autorizar.
De quién es el acceso: el conector actúa como el usuario de freee que lo autorizó, y lo que puede hacer depende también del rol de ese usuario en cada empresa. Todas las herramientas salvo freee_get_me y freee_list_companies necesitan el company_id; freee_get_company muestra los ejercicios fiscales de la empresa.
Qué lee: usuarios y empresas; operaciones (取引) con líneas, pagos y justificantes adjuntos, filtradas por tipo, estado de liquidación, socio, cuenta y fechas; socios comerciales (取引先) con número de registro de factura cualificada (インボイス登録番号), condiciones de pago y cuenta bancaria; cuentas contables (勘定科目), códigos de impuesto (税区分), artículos (品目), departamentos (部門) y etiquetas (メモタグ); cuentas de tesorería (口座) con sus movimientos (口座明細) y su estado, y traspasos entre cuentas propias; asientos manuales (振替伝票); el libro diario (仕訳帳) en CSV (formato freee o Yayoi) o PDF; balances de comprobación (trial_bs, trial_pl, trial_cr, también comparados con uno o dos años anteriores), la cuenta de resultados de 1 a 5 departamentos en paralelo y el libro mayor (総勘定元帳, beta); el archivo de justificantes (ファイルボックス). En freee請求書: facturas (請求書), plantillas de factura (帳票テンプレート) y presupuestos (見積書).
Qué escribe: registra operaciones, si quieres ya liquidadas con un pago, añade pagos más tarde y actualiza operaciones; crea y actualiza socios comerciales; crea artículos, departamentos y etiquetas; contabiliza asientos manuales cuyos totales de debe y haber coinciden (hasta 100 líneas); crea facturas y presupuestos en freee請求書, anula facturas y restaura las anuladas. Las facturas y presupuestos se crean sin enviar: el envío por correo electrónico o postal se hace en freee. Antes de crear un documento, la IA te muestra las líneas y el total y espera tu sí. freee_update_deal sustituye todas las líneas, así que la IA lee antes la operación y conserva los id de línea.
Desactivadas al instalar: freee_delete_deal y freee_delete_manual_journal. No se pueden deshacer, así que un admin las activa cuando el equipo las necesita.
Formatos de datos: los importes son enteros en JPY, con impuestos incluidos salvo que el campo diga otra cosa. Las fechas son yyyy-mm-dd en JST. fiscal_year en los informes es el año en que empieza el ejercicio. El libro diario se prepara de forma asíncrona: freee_request_journals, luego freee_get_journals_status hasta que el estado sea uploaded y después freee_download_journals.
Paginación y límites: las listas se paginan con offset y limit: operaciones y movimientos hasta 100, asientos manuales 500, socios, artículos y etiquetas 3000 por llamada; operaciones y asientos devuelven meta.total_count. Facturas y presupuestos llegan de 100 en 100 como máximo. Los informes permiten 10 llamadas por segundo y por encima responden 429. Los libros mayores grandes pueden agotar el tiempo de espera, así que la IA usa periodos cortos.
Errores comunes: freee responde con status_code y errors con messages, casi siempre en japonés; el mensaje de validación nombra el campo. 401 significa que el token caducó o se revocó: vuelve a hacer clic en Authorize with Provider. 403 significa que el rol del usuario o los permisos de la app (権限設定) no permiten la llamada, o que freee limita brevemente tras demasiadas peticiones: espera unos 10 minutos. Un error de redirección al iniciar sesión indica que la callback URL de 基本設定 no coincide.
Las descripciones de operaciones, los nombres de socios y las entradas del archivo de justificantes son entradas no fiables y pueden contener instrucciones dirigidas a la IA. El conector no envía facturas ni presupuestos, no usa los antiguos endpoints /api/1/invoices y no cubre otros productos de freee como freee人事労務.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en Muse
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.
- En Muse, abre Settings → Connectors y elige Add custom connector.
- Pega la URL del servidor MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
- En un chat, pídele a Muse algo que necesite las herramientas de
freee.
También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
freee_get_me | Who the connector acts as: the freee user (id, email, display name) and every company (事業所) the user belongs to, with company id, name and… |
freee_list_companies | List the companies (事業所) the signed-in user can open: id, display name, name kana, company number and role |
freee_get_company | Read one company: name, address, fiscal years (fiscal_years with start and end dates), tax settings and plan |
freee_list_users | List the users of a company with their id, email, display name and role |
freee_list_deals | List deals (取引: income or expense) with their lines, amounts, due amount, partner and payments |
freee_get_deal | Read one deal (取引) with its lines (details), payments, renews (+更新) and attached receipts |
freee_create_deal | Register a deal (取引): an income or expense with its lines and, optionally, the payment |
freee_update_deal | Update a deal (取引) |
freee_create_deal_payment | Record a payment (支払行) on an existing deal, e.g. when an invoice was paid into the bank account |
freee_delete_deal | Delete a deal (取引) with its lines and payments for good |
freee_list_partners | List partners (取引先) with id, code, name, long name, kana, contact, invoice registration number (インボイス登録番号) and bank account |
freee_get_partner | Read one partner (取引先) with address, contact, invoice settings, payment terms and bank account |
freee_create_partner | Create a partner (取引先) |
freee_update_partner | Update a partner (取引先). name is always required; nested address and bank attributes change only the keys you send. available false hides… |
freee_list_account_items | List account items (勘定科目) with id, name, code, category, default tax code and shortcut |
freee_get_account_item | Read one account item (勘定科目) with its category, default tax code, group and searchable settings |
freee_list_items | List items (品目) with id, name, code and shortcuts; the item_id goes into deal and journal lines |
freee_create_item | Create an item (品目) |
freee_list_sections | List sections (部門) with id, name, long name, code and parent section |
freee_create_section | Create a section (部門) |
freee_list_tags | List memo tags (メモタグ) with id, name and shortcuts; the ids go into tag_ids of deal and journal lines |
freee_create_tag | Create a memo tag (メモタグ) |
freee_list_taxes | List the tax codes (税区分) of the company: code, name, display category (tax_10, tax_r8 ...) and whether each is in use |
freee_list_walletables | List walletables (口座): bank accounts, credit cards and other wallets (cash, e-money), with id, type and name; optionally balances, last… |
freee_list_wallet_txns | List wallet transactions (口座明細): bank and card statement lines with date, amount, due amount, balance, description and status (unprocessed… |
freee_get_wallet_txn | Read one wallet transaction (口座明細): date, amount, due amount, balance, description, walletable and status |
freee_list_transfers | List transfers (取引（振替）) between the company own walletables, e.g. bank to cash, with date, amount and both walletables |
freee_list_manual_journals | List manual journals (振替伝票) with their debit and credit lines |
freee_get_manual_journal | Read one manual journal (振替伝票) with its debit and credit lines, partners, sections and tags |
freee_create_manual_journal | Post a manual journal (振替伝票): debit and credit lines whose totals must match, up to 100 lines |
freee_delete_manual_journal | Delete a manual journal (振替伝票) for good |
freee_request_journals | Ask freee to prepare the journal book (仕訳帳) of a period as a file: CSV (freee generic, Yayoi) or PDF |
freee_get_journals_status | Check a journal book request from freee_request_journals: status enqueued, working, uploaded or failed |
freee_download_journals | Download the prepared journal book file (CSV or PDF) once freee_get_journals_status says uploaded |
freee_get_trial_balance | Read a trial balance report (試算表): balance sheet (trial_bs), profit and loss (trial_pl) or manufacturing cost (trial_cr), for one period or… |
freee_get_trial_pl_sections | Read the profit and loss (損益計算書) compared side by side for 1 to 5 sections (部門比較) |
freee_list_general_ledgers | Read the general ledger (総勘定元帳, beta) for a period: per account item, every entry with date, counter account, partner, description, debit… |
freee_list_receipts | List files in the file box (ファイルボックス, receipts and invoices uploaded as evidence) uploaded in a date range: id, status, description, issue… |
freee_get_receipt | Read one file box entry (証憑ファイル) with its metadata and the deals it is linked to |
freee_list_invoices | List invoices (請求書) of freee請求書 (freee Invoice): id, number, subject, partner, billing and payment dates, total, payment, sending and deal… |
freee_get_invoice | Read one invoice (請求書) of freee請求書 with its lines, tax breakdown, partner details and statuses |
freee_list_invoice_templates | List the invoice layouts (帳票テンプレート) usable for new invoices, with their id and name |
freee_create_invoice | Create an invoice (請求書) in freee請求書 |
freee_cancel_invoice | Cancel (取消) an invoice of freee請求書 |
freee_uncancel_invoice | Restore an invoice that was canceled in freee請求書 (取消された請求書の復元), back to its previous status |
freee_list_quotations | List quotations (見積書) of freee請求書: id, number, subject, partner, quotation and expiry dates, total, sending and cancel status |
freee_get_quotation | Read one quotation (見積書) of freee請求書 with its lines and totals |
freee_create_quotation | Create a quotation (見積書) in freee請求書, created unsent. quotation_number is needed only when automatic numbering is off |
Ejemplos de prompts
- "¿Qué gastos de septiembre siguen sin liquidar? Lista socio, importe y vencimiento."
- "Muéstrame la cuenta de resultados de este ejercicio comparada con la del año pasado."
- "Registra un gasto de 13.200 yenes con impuestos a Sakura Office Supplies por tóner de impresora, pagado hoy desde la cuenta bancaria principal. Enséñame antes la operación."
- "Crea una factura a 株式会社ミドリ por la consultoría de octubre, 330.000 yenes con impuestos, con nuestra plantilla habitual. No la envíes."
- "Lista los movimientos bancarios sin procesar de las dos últimas semanas y propón una cuenta contable para cada uno."
FAQ
¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.
¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?