freee MCP Server: Setup for Claude, Cursor and Other Apps

• Reads any freee record, such as deals, invoices or employees

  Fetches data from freee by API path, for example a list of deals. The path is checked against freee's API definition before the call goes out.

  Try: “List my freee deals from last month.”

  Network · freee_api_get

• Lists the freee API paths your assistant can call

  Returns the endpoints the server knows about, so the assistant can pick the right path before it reads or writes.

  Try: “Which freee endpoints can you use for expense reports?”

  Read · freee_api_list_paths

• Lists the freee companies (offices) you can access

  Shows the companies your freee account belongs to, with their IDs, so the assistant can work in the right one.

  Try: “Which freee companies do I have access to?”

  Network · freee_list_companies

• Shows which freee company is selected

  Reports the company all later requests will use. Requests that name a different company ID are rejected.

  Try: “Which freee company are we working in?”

  Read · freee_get_current_company

• Switches the freee company used for requests

  Picks the company the assistant works in from now on. It changes the saved setting, not any freee data.

  Try: “Switch to my second company in freee.”

  Write · freee_set_current_company

• Shows who you are signed in as and the active company

  Fetches your freee user profile and the company currently selected, to confirm the right account is connected.

  Try: “Which freee user am I signed in as?”

  Network · freee_current_user

• Checks whether you are signed in to freee

  Reports the sign-in state, so the assistant can tell you to log in again when the session has run out.

  Try: “Am I still signed in to freee?”

  Read · freee_auth_status

• Shows the server version and settings

  Returns basic details about the running freee server, such as its version.

  Try: “Which version of the freee MCP server is running?”

  Read · freee_server_info

• Creates new freee records, such as deals or invoices

  Sends a create request to freee with the body the assistant builds. This can make real accounting entries, so check the details before you approve.

  Try: “Create an invoice for Acme for 100,000 yen, copying last month's one.”

  Write · freee_api_post

• Replaces or updates an existing freee record

  Sends an update request to a freee record by its path. Changes are saved in your books at once.

  Try: “Change the due date on deal 123 to the end of next month.”

  Write · freee_api_put

• Changes part of an existing freee record

  Sends a partial update to a record, so only the fields you name are changed.

  Try: “Update the memo on expense application 45.”

  Write · freee_api_patch

• Uploads a file from your computer to freee's file box

  Reads a file from a path on your machine and sends it to the freee file box with optional details such as partner name, date and amount. Only available when you run the server locally.

  Try: “Upload ~/Downloads/receipt.pdf to freee as a receipt.”

  Write · freee_file_upload

• Deletes a freee record by its path

  Sends a delete request to freee for the record at the path you give. The assistant can remove real deals, invoices and other entries, so approve each call yourself.

  Try: “Delete the draft invoice with ID 789.”

  Delete · freee_api_delete

• Signs the local server out of freee

  Removes the saved sign-in details so the next request asks you to log in again.

  Try: “Sign me out of freee.”

  Write · freee_clear_auth

• Starts the freee sign-in in your browser

  Opens the sign-in flow for the local server and saves the result. You only need it the first time, and it is not part of the hosted server.

  Try: “Sign me in to freee.”

  Write · freee_authenticate

Watch out for

• It can delete freee records

  The delete tool sends a real delete request to freee. Approve each call and check the path first. github.com

• It can create and edit accounting entries

  The create and update tools write straight to your books. Review the body of each call before you accept it. github.com

• No read-only mode is documented

  The README lists no switch to turn writes off. Use a freee account or role that can only view data if you want read-only use. github.com

• The file upload tool reads a path you give it

  On the local server, the upload tool reads any file path the assistant names and sends it to freee. Check the path before you allow it. github.com

Security advisories