Freee MCP Server

Official MCP server for freee API integration, enabling AI agents to interact with freee's accounting, HR, invoicing, time tracking, sales, and e-signature (sign) APIs.

Features

• Multiple API Support: Accounting, HR/Payroll, Invoicing, Time Tracking, Sales APIs
• E-signature Support: freee Sign document management via dedicated freee-sign-mcp command
• OAuth 2.0 + PKCE: Secure authentication with automatic token refresh
• Multi-company Support: Dynamic switching between companies/offices

APIs Covered

Accounting API

Manage transactions, accounts, partners, invoices, expense claims, etc. (32 references)

HR/Payroll API

Manage employees, attendance, payslips, year-end adjustments, etc. (28 references)

Invoicing API

Create and manage invoices, quotes, delivery notes (4 references)

Time Tracking API

Manage projects, teams, partners, hours, users, etc. (7 references)

Sales API

Manage deals, orders, master data (5 references)

Sign API (E-signature)

Manage documents, folders, templates, stamps, etc. (8 references) via freee-sign-mcp

Available Tools

Management Tools

• freee_authenticate - Execute OAuth authentication (stdio only)
• freee_auth_status - Check authentication status
• freee_clear_auth - Clear authentication info
• freee_set_current_company - Switch current company
• freee_get_current_company - Show current company
• freee_list_companies - List all companies
• freee_current_user - Get current user info
• freee_server_info - Get server information
• freee_file_upload - Upload files (stdio only)

API Tools

• freee_api_get - Retrieve data (e.g., /api/1/deals)
• freee_api_post - Create new resources
• freee_api_put - Update resources
• freee_api_delete - Delete resources
• freee_api_patch - Partial update
• freee_api_list_paths - List available endpoints

All paths are automatically validated against OpenAPI schemas.

Sign Tools (via freee-sign-mcp)

• sign_authenticate - Execute OAuth for Sign API
• sign_auth_status - Check Sign authentication status
• sign_clear_auth - Clear Sign authentication
• sign_api_get, sign_api_post, sign_api_put, sign_api_patch, sign_api_delete - Sign API operations

Best Practices

For creating similar data repeatedly (invoices, expense reports), reference previous data to work efficiently:

• Invoice creation: Retrieve past invoices to reference partners, items, tax categories
• Expense reports: Reference past claims for accurate account and department assignments
• Transaction registration: Reference similar transactions to prevent input errors

Example: "Create this month's invoice referencing last month's invoice to XX company"

Agent Skills

This MCP server is designed to work with Agent Skills (API references and operation recipes) that inject context for accurate API usage. Skills can be installed via:

• Claude Desktop: Upload freee-api-skill.zip from Releases
• npx skills add freee/freee-mcp
• gh skill install freee/freee-mcp freee-api-skill
• apm install freee/freee-mcp/skills/freee-api-skill
• Claude Code plugin: /plugin marketplace add freee/freee-mcp then /plugin install freee-mcp@freee-mcp-marketplace