# freee MCP for AI Agents AI Agent Connect

> freee MCP lets your AI agent manage Japanese accounting and HR tasks directly. Track deals, audit invoices, handle business partners, and manage employee expenses without leaving your chat interface. It connects your freee account to any AI client so you can handle complex Japanese tax mappings and general ledger entries using natural language.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mBJJu4QNHd8r0NqJx1YtOBSFbBadt9Yxl5fr0tYC/ai-agent-connect
- **Tags:** tax-compliance, general-ledger, invoicing, expense-management, payroll, japanese-accounting

## Description

Imagine you're trying to reconcile a messy set of Japanese business accounts. Usually, that means jumping into the freee web portal, digging through tabs, and manually checking invoice statuses or tax codes. It's a slog. This Connector changes that by letting your AI agent do the heavy lifting for you. You can just ask your agent to find all overdue invoices or check the status of a specific employee's expense claim. It handles the grunt work of pulling data from your general ledger and organizing it into something you can actually use to make decisions. Whether you're trying to map out 8% and 10% tax rates across a bulk list or just need to see which bank accounts are currently synced, the agent handles the data retrieval. You get to stay in your primary workspace while the agent navigates the complexities of Japanese accounting rules. It’s one of the most practical ways to use the Vinkius catalog to get actual work done rather than just moving data around. You're basically giving your agent a seat in the accounting office.

## Tools

### get_deal
View specific details for a single accounting transaction. This is useful for checking settlement flags on a per-deal basis.

### list_partners
Pull a complete list of all your business partners and vendors. Use this to get a high-level view of your business counterparts.

### get_partner
Retrieve detailed profiles for a specific customer or vendor. This helps you find tax IDs and contact info quickly.

### list_accounts
Get a list of all account items within your freee instance. This provides a clear map of your general ledger structure.

### list_taxes
Pull all registered Japanese tax codes and mappings. This is essential for verifying correct tax applications on deals.

### list_invoices
Retrieve every invoice in your system to check their current status. Use this to quickly identify overdue payments.

### list_expenses
View all employee expense applications and their current approval states. This helps managers track pending claims.

### list_deals
Pull all accounting deals to see a high-level view of your transactions. It's the fastest way to audit recent activity.

### list_walletables
See all connected bank accounts, credit cards, and cash wallets. This gives you a snapshot of your current liquidity.

## Prompt Examples

**Prompt:** 
```
List the last 5 accounting deals in freee
```

**Response:** 
```
### Recent Transactions

| Date | Description | Amount | Status |
| :--- | :--- | :--- | :--- |
| 2024-05-01 | Client A Payment | ¥150,000 | Completed |
| 2024-05-02 | Office Rent | -¥80,000 | Completed |
| 2024-05-03 | Stationery | -¥2,500 | Pending |
| 2024-05-04 | Software Sub | -¥12,000 | Completed |
| 2024-05-05 | Client B Deposit | ¥300,000 | Completed |

Would you like to see the settlement details for any of these?
```

**Prompt:** 
```
Show me pending expense applications
```

**Response:** 
```
### Pending Expenses

I found **3 applications** awaiting managerial approval:

*   **Taxi Fare** - Submitted by John (¥3,200)
*   **Client Lunch** - Submitted by Sarah (¥5,400)
*   **Stationery** - Submitted by Mike (¥1,200)

I can provide the receipts for these if you need to review them.
```

**Prompt:** 
```
What are my active bank accounts in freee?
```

**Response:** 
```
### Connected Wallets

Your freee instance has **3 active accounts**:

*   **MUFG Main**: ¥2,500,000 (Synced 2 hours ago)
*   **Corporate Visa**: -¥120,000 (Synced 1 hour ago)
*   **Petty Cash**: ¥50,000 (Offline)

Let me know if you need a balance for a specific account.
```

## Capabilities

### Audit invoice statuses
Check if invoices are sent, paid, or overdue across your entire account.

### Map Japanese tax rates
Identify 8%, 10%, and reduced tax mappings for your business.

### Track employee expenses
View submitted claims and their current approval states.

### Manage business partners
List and retrieve vendor and customer profiles in one place.

### Monitor bank balances
View connected accounts and offline cash repositories.

### Inspect accounting deals
Get sub-entry details and settlement flags for specific transactions.

## Use Cases

### Checking Overdue Invoices
An owner asks 'What invoices are overdue?' and the agent uses `list_invoices` to find them and report the totals.

### Expense Approval
An ops manager asks 'Are there any pending expenses?' and the agent uses `list_expenses` to show the list of names and amounts.

### Tax Mapping
An accountant asks 'What are our current tax rates?' and the agent uses `list_taxes` to pull the registered mappings.

### Partner Lookup
A sales rep asks 'Who is our main vendor for office supplies?' and the agent uses `list_partners` to find the correct profile.

## Benefits

- Stop manual data entry by letting your AI client pull accounting deals and invoices automatically using `list_deals` and `list_invoices`.
- Get instant visibility into your cash flow by viewing all connected bank accounts and wallets with `list_walletables`.
- Simplify tax compliance by quickly pulling and reviewing Japanese tax mappings with `list_taxes`.
- Speed up expense approvals by checking employee claims and their current status using `list_expenses`.
- Organize your contact list easily by retrieving vendor and customer profiles with `list_partners` and `get_partner`.
- Audit your accounts receivable without clicking through menus by checking invoice statuses via `list_invoices`.

## How It Works

The bottom line is you get a conversational interface for your entire Japanese accounting backend.

1. Subscribe to the freee MCP through Vinkius.
2. Enter your freee Access Token and Company ID from your Developer Console.
3. Ask your AI client to pull reports, check invoices, or list partners.

## Frequently Asked Questions

**Can the freee MCP help with Japanese tax codes?**
Yes, this Connector allows your AI client to pull all registered Japanese tax mappings directly from your account. You can ask about specific rates like 8% or 10% to ensure your deals are mapped correctly.

**Can I use freee MCP to see my bank balances?**
Yes, you can ask your agent to check your connected bank accounts and wallets. It will pull the current balance and the last sync time for all your connected financial repositories.

**Does freee MCP work for expense tracking?**
It does. You can use it to list all employee expense applications and see which ones are still pending approval or have already been settled.

**Can I check invoice statuses with freee MCP?**
Yes, your AI client can retrieve every invoice in your system. You can ask it to identify which ones are sent, paid, or currently overdue to manage your accounts receivable.

**Is freee MCP good for Japanese business owners?**
It's a great tool for owners who want a high-level view of their cash flow and business health. It lets you get answers to quick questions without having to navigate the full accounting software.

**How do I connect my freee account to an AI?**
First, subscribe to the Connector on Vinkius. Then, you'll need to provide your freee Access Token and Company ID, which you can find in your freee Developer Console.

**Can my agent list all unpaid invoices in freee?**
Yes. Use the 'list_invoices' tool. The agent retrieves explicitly attached invoice states, allowing you to filter for 'unpaid' or 'overdue' status to monitor your tenant's AR limits flawlessly.

**How do I check the details of a specific business partner via chat?**
Use the 'get_partner' tool. Provide the Partner ID. Your agent will retrieve the strict physical mapping from the freee address book, including vendor/customer profiles and tax ID metadata.

**Can I see my connected bank accounts and their balances through the agent?**
Absolutely. The 'list_walletables' tool identifies connected physical bank accounts, credit cards, and cash repositories. You can query current balances and sync states natively within your chat context.