io.usefulapi/smarthr

up checked 2026-11-11T06:37:25.767Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

SmartHR MCP by usefulapi

Publisher-provided description

MCP server for SmartHR — employees, departments, dependents and employee invitations.

Summary by lookupd

Lets an agent read and update SmartHR employees, departments, dependents and invitations, including sending invitation emails.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http smarthr https://smarthr.usefulapi.io/mcp

Codex, remote (streamable-http)

codex mcp add smarthr --url https://smarthr.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (23 tools)

Publisher-provided text

• smarthr_list_employees List employees (従業員) of the SmartHR tenant, with filters: free-text name/department/position search, status (employed, absent, retired), employee number, employ
• smarthr_get_employee Get one employee (従業員) by id. Returns a compact record; use `fields` for more (address, phone, birth date, custom fields, contract dates). Sensitive data is nev
• smarthr_list_dependents List the dependents (家族情報) registered for one employee: name, relation, birth date, living arrangement and support status. Pension numbers, income and documents
• smarthr_list_maternity_childcare_leaves List the maternity and childcare leave records (産休育休) of one employee: expected birth, leave start/end and scheduled return dates. Bank, insurance and memo data
• smarthr_list_departments List departments (部署) with their hierarchy (parent, children), code and company.
• smarthr_get_department Get one department (部署) by id, with its parent and children.
• smarthr_list_positions List positions / job titles (役職) with their rank and code.
• smarthr_list_employment_types List employment types (雇用形態), e.g. full-timer, part-timer, contract worker, with their ids for filtering and writes.
• smarthr_list_grades List grades (等級) with their rank.
• smarthr_list_job_categories List job categories (職種).
• smarthr_list_companies List the companies (会社) of the tenant: name, code, corporate number, address, phone.
• smarthr_list_business_establishments List business establishments (事業所): name, social insurance and labor insurance registration data, company.
• smarthr_list_employee_custom_fields List the definitions of the tenant's custom employee fields (カスタム従業員項目): name, type and, for dropdowns, the choices. Use them to read the values in custom_field
• smarthr_list_dependent_relations List the relation types for dependents (続柄: spouse, child, parent...) with their ids, needed by smarthr_create_dependent.
• smarthr_list_users List SmartHR users (login accounts): email, administrator flag, role, linked employee, and the invitation status (created, opened, accepted, answered). Use it t
• smarthr_list_employee_input_forms List the employee information collection forms (従業員情報収集フォーム) that an invitation can use.
• smarthr_list_webhooks List the configured webhooks (target URL, which employee and dependent events notify). Read-only; secret tokens and the query string of the target URL are never
• smarthr_create_employee WRITE: Register a new employee (従業員) in SmartHR. Nothing is sent to the employee; to invite them to fill in their own data use smarthr_invite_employee afterward
• smarthr_update_employee WRITE: Change fields of one existing employee (partial update: only the fields you give change; others stay). Typical uses: set the status to absent or retired
• smarthr_create_department WRITE: Create a department (部署). Give the parent department id to nest it. Returns the created department.
• smarthr_update_department WRITE: Rename or move one department (partial update: only the fields you give change). Returns the updated department.
• smarthr_create_dependent WRITE: Register a dependent (家族情報) for an employee. Needs the relation id from smarthr_list_dependent_relations. Returns the created dependent without pension n
• smarthr_invite_employee WRITE, SENDS AN EMAIL: Invite an employee to SmartHR. SmartHR emails the address stored on the employee (the employee must have one) an invitation to create the

Details

• Version: 1.8.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 315 ms
• First indexed: 2026-11-01T10:06:12.499Z
• Last seen in registry: 2026-11-11T00:17:34.098Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/smarthr/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/smarthr.svg)](https://lookupd.com/servers/io.usefulapi/smarthr)

• 62071 servers
• Last crawl: 2026-11-11T16:17:25.167Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp