{"id":"freee-freee-mcp","name":"freee-mcp","homepage":"https://www.freee.co.jp/","repo_url":"https://github.com/freee/freee-mcp","category":"automation","subcategories":[],"tags":["mcp","freee","oauth","pkce","agent-skills","accounting","hr","invoicing","time-management","sales","typescript"],"what_it_does":"freee-mcp is an MCP server plus “Agent Skills” for automating freee accounting, HR/payroll, invoicing, time/attendance management, and sales via an AI agent. It supports OAuth 2.0 with PKCE, provides tools for authentication and company (事業所) switching, and validates request paths/parameters against an OpenAPI schema before calling the freee APIs.","use_cases":["Enable an AI agent to fetch and operate freee data (e.g., deals, invoices, expenses) using MCP tools","Create/preview records (e.g., invoices, expenses) by referencing prior data for consistency","Support multi-site (事業所) workflows with dynamic company switching","Build agent workflows that require structured API calling and schema-validated requests"],"not_for":["Direct human manual usage without an agent/MCP client","Use-cases needing real-time notifications/webhooks from freee-mcp","Use-cases requiring a conventional public REST API/SDK for your application code (the primary interface is MCP + skills)"],"best_when":"You want a model/agent to safely call freee APIs with enforced request validation, using the remote MCP endpoint or a local MCP process, and you can provide OAuth credentials.","avoid_when":"You cannot manage OAuth consent/credentials or you need webhooks or push-based event handling (not indicated here).","alternatives":["Direct freee API integration (developer.freee.co.jp) from your own backend","Other MCP servers/wrappers for freee (if available) or generic HTTP MCP tooling","Agent-tooling via OpenAI function calling or other tool frameworks with your own OpenAPI-driven router/validator"],"af_score":68.0,"security_score":70.0,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:32:48.901766+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":"https://mcp.freee.co.jp/mcp","has_sdk":false,"sdk_languages":["TypeScript"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["OAuth 2.0 + PKCE (interactive configure / freee_authenticate tool)","Token auto refresh (as described)"],"oauth":true,"scopes":false,"notes":"Authentication is described as OAuth 2.0 + PKCE with a configure wizard and tools like freee_authenticate/freee_auth_status/freee_clear_auth. The README does not enumerate specific OAuth scopes in detail."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information is provided in the supplied content; this appears to be an open-source integration layer."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":68.0,"security_score":70.0,"reliability_score":36.2,"mcp_server_quality":85.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":70.0,"rate_limit_clarity":40.0,"tls_enforcement":80.0,"auth_strength":85.0,"scope_granularity":45.0,"dependency_hygiene":65.0,"secret_handling":70.0,"security_notes":"Uses OAuth 2.0 + PKCE and mentions request validation against an OpenAPI schema; also uses helmet and rate-limit middleware per manifest dependencies. Specific practices for secret storage/log redaction and exact scope granularity are not detailed in the provided README, so scores reflect partial visibility.","uptime_documented":0.0,"version_stability":60.0,"breaking_changes_history":40.0,"error_recovery":45.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["For operations that include company_id: you must ensure the company_id matches the currently selected 事業所; mismatches trigger errors.","Some tools are stdio-only (freee_authenticate/freee_file_upload), so the MCP client integration must support that transport.","Remote MCP URL is provided as the official endpoint; using a different URL is explicitly warned against."]}}