SmartHR MCP by usefulapi

usefulapi の SmartHR MCP

API が有効な SmartHR アカウントに接続します。

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://smarthr.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http smarthr https://smarthr.usefulapi.io/mcp を実行し、続いて /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "smarthr": {
      "url": "https://smarthr.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアントの設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで SmartHR の認証情報を求められます。

手順ごとのセットアップ方法、認証情報の確認方法、FAQ：https://usefulapi.io/smarthr/

ツール

ツール	種類	内容
smarthr_list_employees	読み取り	従業員の一覧を取得
smarthr_get_employee	読み取り	従業員を取得
smarthr_list_dependents	読み取り	従業員の扶養家族の一覧を取得
smarthr_list_maternity_childcare_leaves	読み取り	従業員の産休・育休の一覧を取得
smarthr_list_departments	読み取り	部署の一覧を取得
smarthr_get_department	読み取り	部署を取得
smarthr_list_positions	読み取り	役職の一覧を取得
smarthr_list_employment_types	読み取り	雇用形態の一覧を取得
smarthr_list_grades	読み取り	等級の一覧を取得
smarthr_list_job_categories	読み取り	職種の一覧を取得
smarthr_list_companies	読み取り	会社の一覧を取得
smarthr_list_business_establishments	読み取り	事業所の一覧を取得
smarthr_list_employee_custom_fields	読み取り	従業員カスタムフィールドの定義一覧を取得
smarthr_list_dependent_relations	読み取り	扶養家族との続柄の一覧を取得
smarthr_list_users	読み取り	ユーザーの一覧を取得
smarthr_list_employee_input_forms	読み取り	従業員入力フォームの一覧を取得
smarthr_list_webhooks	読み取り	Webhook の一覧を取得
smarthr_create_employee	書き込み	従業員を作成
smarthr_update_employee	書き込み	従業員を更新
smarthr_create_department	書き込み	部署を作成
smarthr_update_department	書き込み	部署を更新
smarthr_create_dependent	書き込み	扶養家族を登録
smarthr_invite_employee	書き込み	メールで従業員を招待
smarthr_usage_status	メタ	利用状況（無料プランの利用量）
smarthr_request_feature	メタ	不足している機能をリクエスト
smarthr_upgrade	メタ	Pro または Pro+ にアップグレード
smarthr_cancel_subscription	メタ	Pro サブスクリプションを解約

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で実行前に確認してください。meta ツールは利用状況を報告し、サブスクリプションを管理するか、機能リクエストを送信します。

料金

プラン	料金	上限
Free	$0	月 50 回のツール呼び出し
Pro（SmartHR テナント単位）	$9/月 または $90/年（2 か月分無料）	無制限*

*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] までご連絡ください。

Pro の対象はこのサーバーのみです。smarthr_upgrade を使用して登録してください（Stripe Checkout のリンクが返されます）。smarthr_cancel_subscription を使用すればいつでも解約できます。Pro は支払い済み期間の終了まで継続し、現在の期間分の返金はありません。終了前に smarthr_upgrade を実行すると、解約が取り消されます。または、[email protected] までご連絡ください。

ライセンス

MIT