# freee MCP > freee MCP connects your Japanese accounting and HR operations directly to any AI client. Use natural conversation to manage general ledger entries, audit invoices, track expenses, and verify tax codes across your entire business. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** tax-compliance, general-ledger, invoicing, expense-management, payroll, japanese-accounting ## Description You can take full control of complex Japanese business records without logging into the freee portal. This MCP lets you talk through financial tasks—like checking if an invoice is paid or identifying which accounts are connected to credit cards—and it handles the heavy lifting. Need to audit tax rates? Just ask. Want to see what expenses are waiting for manager approval? It's there. The connection makes sense because this entire catalog lives on Vinkius, giving your AI agent access to all of freee’s core functions in one place. You can use natural language to get details on specific deals, check official business counterpart records, or even list out every connected bank account and wallet for a quick cash flow overview. ## Tools ### list_deals Retrieves a list of all accounting deals (transactions) that have been recorded. ### get_deal Fetches detailed information on a specific transaction or deal. ### list_partners Lists all official business counterparts (vendors and customers) linked to your accounts. ### get_partner Gets detailed profile information for a specific partner using their ID. ### list_accounts Lists all financial account items tracked within your freee system. ### list_walletables Retrieves a summary of all connected bank accounts and digital wallets. ### list_taxes Lists available Japanese tax codes, helping you confirm compliance rates like 8% or 10%. ### list_invoices Retrieves a list of all invoices and their current sending status. ### list_expenses Lists expense applications submitted by employees that need review or settlement. ## Prompt Examples **Prompt:** ``` List the last 5 accounting deals in freee ``` **Response:** ``` Retrieving deals... I found 5 recent transactions including an income entry from 'Client A' (¥150,000) and an expense for 'Office Rent' (¥80,000). Would you like to see the settlement details for any of these? ``` **Prompt:** ``` Show me pending expense applications ``` **Response:** ``` Analyzing expenses... There are 3 applications pending managerial approval: 'Taxi Fare' from John, 'Client Lunch' from Sarah, and 'Stationery' from Mike. I can provide the receipts and total amounts for you. ``` **Prompt:** ``` What are my active bank accounts in freee? ``` **Response:** ``` Checking wallets... You have 3 connected accounts: 'MUFG Main' (¥2,500,000), 'Corporate Visa' (-¥120,000), and 'Petty Cash' (¥50,000). The MUFG account was last synced 2 hours ago. ``` ## Capabilities ### Manage Accounting Transactions List all accounting deals (transactions) that occurred in your company. ### Inspect Deal Details Get specific details about any given deal, including settlement flags and bank connection boundaries. ### Check Invoice Statuses Retrieve the current status of all invoices (sent, paid, overdue) for your accounts receivable records. ### List Business Partners Get a complete list of every vendor and customer in your system with their associated tax IDs. ### Track Employee Expenses Review submitted expense applications and see what stage they're at, especially regarding manager approval. ### View Financial Accounts List all connected bank accounts, credit cards, and physical cash repositories tracked in your freee instance. ## Use Cases ### Closing the books on accounts receivable The Accounting Manager needs to know which clients haven't paid their bills. Instead of opening the invoice module and filtering by date, they ask the agent to list invoices. The response immediately flags all records that are overdue, letting them prioritize collection efforts. ### Verifying expenses before payroll The Ops Manager receives a batch of expense reports for review. They don't need to open each one; they ask the agent to list expenses. The output shows all three applications pending approval, letting them know exactly who needs to sign off on what. ### Quick bank balance check The Business Owner is traveling and needs an immediate cash overview. They prompt the agent about active accounts. It pulls up a list of walletables, showing current balances for corporate cards and main operational banks in seconds. ### Onboarding new vendors The team is setting up a new supplier. Instead of manually checking vendor databases, they prompt the agent to use list_partners. The agent provides all official business counterpart details instantly, including required tax IDs for compliance. ## Benefits - Audit Accounts Receivable: Instead of navigating invoice tabs, you can ask your agent to list invoices directly and immediately check their status (sent, paid, overdue). - Financial Oversight: Get a clear picture of cash flow by listing all walletables. You instantly see every connected bank account and credit card balance. - Expense Approval Tracking: Review pending expense applications using the list_expenses tool. You'll know exactly which submissions are waiting for manager sign-off, saving time on follow-ups. - Tax Compliance Checking: Confirm if your records adhere to Japanese tax law by listing available tax codes and checking rates like 8% or 10%. - Partner Data Integrity: Use list_partners to get a synced directory of every customer and vendor, complete with accurate tax ID profiles. This prevents data mismatch errors. - Transaction Deep Dives: Need to know why a deal was settled? You can use get_deal to pull deep sub-entry details, including specific bank sync boundaries. ## How It Works The bottom line is you manage complex financial tasks through simple conversation instead of clicking through multiple web forms. 1. Subscribe to this MCP and enter your freee Access Token and Company ID from the developer console. 2. Your AI client connects using those credentials, establishing a secure link to your Japanese accounting data. 3. You start by asking natural language questions, like 'What's my outstanding receivables?' and get immediate answers. ## Frequently Asked Questions **How do I check if an invoice is paid using freee MCP?** You can use list_invoices to get a comprehensive list of all invoices. This tool shows you the current status, allowing you to quickly filter for anything that is marked as 'paid' or 'overdue'. **What does freee MCP do with Japanese tax codes?** The MCP allows you to list_taxes. This lets you view and audit all registered Japanese Tax mappings, helping you confirm if the correct rates (like 8% or 10%) are being applied to your records. **Can I see what bank accounts are connected?** Yes. You use list_walletables to retrieve a summary of all connected bank accounts and wallets in your freee instance, providing real-time balance information. **Does freee MCP handle partner verification?** Absolutely. Use list_partners to enumerate official business counterparts. This gives you synchronous access to precise vendor, customer, and tax ID profiles for compliance checks. **How do I find out which expenses are pending approval?** You run the list_expenses tool. This provides a clear overview of all submitted applications, letting you see exactly who submitted the expense and what managerial approval status it's in.