How to Use the freee MCP in Claude

Q: Can I list all my company's accounting deals with freee and Claude Desktop?

Yes. After connecting the server, just ask your agent to listdeals. It will return a list of your company's transactions directly from your freee account.

Q: Is there a way to check bank account balances in freee using Claude Desktop?

Absolutely. The listwalletables tool gives your agent access to bank account and wallet information. You can ask it to fetch current balances for you.

Connect Claude Desktop to your company's Japanese books. Ask your agent to pull invoices, check deals, and audit expenses from freee.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect freee MCP to Claude Desktop

Create your Vinkius account to connect freee to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup freee with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run financial audits in chat

This MCP server connects Claude Desktop directly to your freee accounting data. Ask your agent to `list_invoices` for the last quarter, then have it cross-reference them with transactions from `list_deals`. It’s like having a junior accountant available on demand. You can dig deeper without switching apps. Ask follow-up questions to find discrepancies between expenses and invoices, or use `get_deal` to pull the specifics on a single transaction. The answers appear right in your chat, with the data pulled straight from the source.

Check partner and tax details instantly

Forget searching through your accounting software for vendor information. Just ask your agent to `get_partner` by its ID to pull up contact details and payment terms. It’s faster than finding the login page. When you need to verify tax information, you don't have to bother your finance team in Japan. Your agent can use `list_taxes` to show you the exact tax codes your company is using. This gives you immediate clarity on how transactions are classified.

Connect Claude Desktop to your books

Once you connect this MCP server, your agent gains nine new tools for interacting with freee. It can do more than just read data; it gets a real understanding of your company's financial operations, from high-level accounts down to individual line items. Your agent can access everything from `list_expenses` to `list_walletables`. This gives you a direct line to your accounting platform, turning Claude Desktop into a powerful interface for financial analysis and reporting.

Setup guide

Set up freee MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The freee MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the freee MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under freee-mcp.

json

{
  "mcpServers": {
    "freee-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by freee. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect freee now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about freee MCP in Claude Desktop

Connect the freee MCP Server URL in your Claude Desktop settings under 'Integrations' or 'Custom Connectors'. Once connected, the tools are immediately available to your agent. You don't need to install anything else.

Yes. After connecting the server, just ask your agent to `list_deals`. It will return a list of your company's transactions directly from your freee account.

Absolutely. The `list_walletables` tool gives your agent access to bank account and wallet information. You can ask it to fetch current balances for you.

The main benefit is speed. You can get answers about your Japanese company's finances—invoices, expenses, partners—without leaving your chat window. It's much faster than manually navigating the accounting software.

Your freee credentials are encrypted and used only to fetch data for your requests. The server processes your financial data—like invoices, deals, and partner info—in an ephemeral, zero-trust sandbox for each request. No data is stored.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript