Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

SmartHR MCP by usefulapi

by m190version 1.6.3i★ –iRuns in the cloud
Registry nameio.usefulapi/smarthr

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Install

Pick the AI app you use, then copy the settings.

Before you install

  • Basic checks: 3 of 3 passed
  • Runs on the maker’s server: what you ask it goes through their server.
  • Can do 23 things (tools) smarthr_list_employees, smarthr_get_employee, smarthr_list_dependents, smarthr_list_maternity_childcare_leaves …
  • The registry lists no key to fill in.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

  1. Open Settings → Connectors
  2. Press Add custom connector
  3. Paste the address below and press Add
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Add2https://…3
https://smarthr.usefulapi.io/mcp

Run this in your terminal

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

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "smarthr": {
      "type": "http",
      "url": "https://smarthr.usefulapi.io/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

  1. Open ChatGPT on the web → Settings → Connectors (Apps)
  2. Press Create or Add (some plans need Developer mode under Advanced first)
  3. Paste the address below, give it a name and save
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Create2https://…3
https://smarthr.usefulapi.io/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 6, 2026. The maker wrote them, not us; we show them as plain text.

  • smarthr_list_employees

    List employees (従業員) of the SmartHR tenant, with filters: free-text name/department/position search, status (employed, absent, retired), employee number, employment type, department, position, hire and resignation date ranges. Returns a compact record per employee; use `fields` f

  • 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 never returned.

  • smarthr_list_dependents

    List the dependents (家族情報) registered for one employee: name, relation, birth date, living arrangement and support status. Pension numbers, income and documents are not returned.

  • 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 are not returned.

  • 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_fields.

  • 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 to find the administrator id for smarthr_invite_employee.

  • 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 shown.

  • 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 afterwards. Only the fields you give are set. The tenant plan may cap the number of employees (error plan_limit_exceeded). Return

  • 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 with the resignation date, correct a name, email or phone, move the employee to other departments (department_ids replac

  • 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 number, income or documents.

  • 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 their login and, with an input form, to fill in their own data. Asking again re-sends it (and updates the invited address i

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain usefulapi.io (the registry checks domain ownership)

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 15 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 23 tool descriptions and found no hidden instructions to the AI

Compared with others in Otheri

  • More stars than 0% of the other 32417 servers in this category
  • Published to the registry more recently than 97% of the other 32417 servers in this category
  • Basic checks equal to or better than 100% of the other 32417 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is SmartHR MCP by usefulapi safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.6.3) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, FOGA node

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago
Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday
Install

FOGA node

by garyyang-finchip

A Finch OG Agent cell as an MCP server: read the world, dry-run and take ERC-8414 tenders by policy.

Computer or cloudUpdated today
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

SmartHR MCP by usefulapi

Connect your API-enabled SmartHR account.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://smarthr.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http smarthr https://smarthr.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
{

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

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your SmartHR credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/smarthr/

Tools

ToolTypeWhat it does
smarthr_list_employeesreadList employees
smarthr_get_employeereadGet an employee
smarthr_list_dependentsreadList an employee's dependents
smarthr_list_maternity_childcare_leavesreadList an employee's maternity and childcare leaves
smarthr_list_departmentsreadList departments
smarthr_get_departmentreadGet a department
smarthr_list_positionsreadList positions
smarthr_list_employment_typesreadList employment types
smarthr_list_gradesreadList grades
smarthr_list_job_categoriesreadList job categories
smarthr_list_companiesreadList companies
smarthr_list_business_establishmentsreadList business establishments
smarthr_list_employee_custom_fieldsreadList employee custom field definitions
smarthr_list_dependent_relationsreadList dependent relations
smarthr_list_usersreadList users
smarthr_list_employee_input_formsreadList employee input forms
smarthr_list_webhooksreadList webhooks
smarthr_create_employeewriteCreate an employee
smarthr_update_employeewriteUpdate an employee
smarthr_create_departmentwriteCreate a department
smarthr_update_departmentwriteUpdate a department
smarthr_create_dependentwriteCreate a dependent
smarthr_invite_employeewriteInvite an employee by email
smarthr_usage_statusmetaUsage status (free-tier meter)
smarthr_request_featuremetaRequest a missing feature
smarthr_upgrademetaUpgrade to Pro or Pro+
smarthr_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per SmartHR tenant)$9/mo or $90/yr (2 months free)Unlimited*

\*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to support@usefulapi.io.

Pro covers this server only. Subscribe with smarthr_upgrade (it returns a Stripe Checkout link). Cancel any time with smarthr_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running smarthr_upgrade before then undoes the cancel. Or write to support@usefulapi.io.

License

MIT

Ask PopNx