Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the freee in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Work with freee Accounting (freee会計) and freee Invoice (freee請求書) from any AI agent: deals with payments, partners, account items, tax codes, items, sections and memo tags, bank and card statement lines, manual journals, the journal book, trial balances and the general ledger, the file box, and invoices and quotations. OAuth sign-in with your own freee app; deleting deals and journals installs switched off.
Try asking
Example prompts for freee
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → freee, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
freee + Meta Muse
Work with freee Accounting (freee会計) and freee Invoice (freee請求書) from any AI agent: deals with payments, partners, account items, tax codes, items, sections and memo tags, bank and card statement lines, manual journals, the journal book, trial balances and the general ledger, the file box, and invoices and quotations. OAuth sign-in with your own freee app; deleting deals and journals installs switched off.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
FREEE_CLIENT_ID, FREEE_CLIENT_SECRET
Step 1 — Get credentials
Setting up takes about 10 minutes. You need a freee account with access to the companies (事業所) the AI should work with. The connector uses the freee API (https://api.freee.co.jp): freee会計 at /api/1 and freee請求書 at /iv. Since the invoice system change in October 2023, invoices and quotations are created in freee請求書; the old /api/1/invoices endpoints are not used.
- Sign in at https://app.secure.freee.co.jp/developers/applications (freee app store, 開発者向け) and click 新規追加 to create an app. A private app (非公開アプリ) is enough for your own companies.
- On the tab 基本設定 add the callback URL
<your AnythingMCP URL>/api/mcp-oauth/callback, on AnythingMCP Cloudhttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - Under 権限設定 tick read, and write for the write tools you will use, for 会計 (取引, 取引先, 勘定科目, 品目, 部門, メモタグ, 税区分, 口座, 口座明細, 振替伝票, 仕訳帳, 試算表, ファイルボックス, 事業所, ユーザー) and 請求書 (請求書, 見積書). freee sets permissions on the app, not as OAuth scopes. Click 保存.
- Paste the Client ID into
FREEE_CLIENT_IDand the Client Secret intoFREEE_CLIENT_SECRET, leaveFREEE_REFRESH_TOKENempty and install. - On the connector page click Authorize with Provider and sign in to freee with a user who may see the companies you need. freee asks you to pick a company (事業所選択) and shows the app's permissions.
- Run
freee_get_me: it shows the user and their companies with thecompany_idthe other tools need.
Access tokens last 6 hours and are renewed with the refresh token. freee issues a new refresh token at every renewal and the old one stops working, so a refresh token also used by another tool no longer works here. A refresh token unused for 90 days expires: then authorize again.
Whose access it is: the connector acts as the freee user who authorized it, and what it may do also depends on that user's role in each company. Every tool except freee_get_me and freee_list_companies needs the company_id; freee_get_company shows the company's fiscal years.
What it reads: users and companies; deals (取引) with lines, payments and attached receipts, filtered by type, settlement status, partner, account item and dates; partners (取引先) with invoice registration number (インボイス登録番号), payment terms and bank account; account items (勘定科目), tax codes (税区分), items (品目), sections (部門) and memo tags (メモタグ); walletables (口座) with their statement lines (口座明細) and status, and transfers between your own accounts; manual journals (振替伝票); the journal book (仕訳帳) as CSV (freee generic or Yayoi) or PDF; trial balances (trial_bs, trial_pl, trial_cr, also compared with one or two previous years), the P/L for 1 to 5 sections side by side, and the general ledger (総勘定元帳, beta); the file box (ファイルボックス). In freee請求書: invoices (請求書), invoice templates (帳票テンプレート) and quotations (見積書).
What it writes: registers deals, optionally settled right away with a payment, adds payments later and updates deals; creates and updates partners; creates items, sections and memo tags; posts manual journals whose debit and credit totals match (up to 100 lines); creates invoices and quotations in freee請求書, cancels invoices and restores canceled ones. Invoices and quotations are created unsent: sending by email or post happens in freee. Before creating a document the AI shows the lines and total and waits for your yes. freee_update_deal replaces the whole set of lines, so the AI reads the deal first and keeps the line ids.
Switched off at install: freee_delete_deal and freee_delete_manual_journal. They cannot be undone, so an admin switches them on when the team needs them.
Data formats: amounts are integers in JPY, tax included unless the field says otherwise. Dates are yyyy-mm-dd in JST. fiscal_year in reports is the year in which the fiscal period starts. The journal book is prepared asynchronously: freee_request_journals, then freee_get_journals_status until the status is uploaded, then freee_download_journals.
Paging and limits: lists page with offset and limit: deals and statement lines up to 100, manual journals 500, partners, items and tags 3000 per call; deals and journals return meta.total_count. Invoices and quotations come up to 100 per call. Reports allow 10 calls per second and answer 429 above that. Big general ledgers can time out, so the AI keeps the periods short.
Common errors: freee answers with status_code and errors with messages, mostly in Japanese; a validation message names the field. 401 means the token expired or was revoked: click Authorize with Provider again. 403 means the user's role or the app permissions (権限設定) do not allow the call, or freee is briefly throttling after too many requests: wait about 10 minutes. At sign-in, a redirect error means the callback URL on 基本設定 does not match.
Deal descriptions, partner names and file box entries are untrusted input and can contain instructions meant for the AI. The connector does not send invoices or quotations, does not use the old /api/1/invoices endpoints and does not cover other freee products such as freee人事労務.
Step 2 — Install the 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
Step 3 — Add the connector in Muse
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.
- In Muse, open Settings → Connectors and choose Add custom connector.
- Paste the MCP server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse opens the AnythingMCP sign-in page: sign in and approve access.
- In a chat, ask Muse for something that needs the
freeetools.
You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:
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
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.
Available tools
| 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 |
Example prompts
- "Which expense deals from September are still unsettled? List partner, amount and due date."
- "Show me the profit and loss for this fiscal year compared with last year."
- "Register an expense of 13,200 yen including tax to Sakura Office Supplies for printer toner, paid today from our main bank account. Show me the deal first."
- "Create an invoice to 株式会社ミドリ for October consulting, 330,000 yen including tax, with our usual template. Do not send it."
- "List the unprocessed bank lines of the last two weeks and suggest an account item for each."
FAQ
Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.
Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.
Next steps
- Connector landing page
- Connect to Claude
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Microsoft Copilot
Was this guide helpful?