Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
MCP server for SmartHR — employees, departments, dependents and employee invitations.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
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:
https://smarthr.usefulapi.io/mcpRun this in your terminal
claude mcp add --transport http smarthr https://smarthr.usefulapi.io/mcpPaste 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.
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:
https://smarthr.usefulapi.io/mcpMenu 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.
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_employeesList 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_employeeGet 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_dependentsList 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_leavesList 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_departmentsList departments (部署) with their hierarchy (parent, children), code and company.
smarthr_get_departmentGet one department (部署) by id, with its parent and children.
smarthr_list_positionsList positions / job titles (役職) with their rank and code.
smarthr_list_employment_typesList employment types (雇用形態), e.g. full-timer, part-timer, contract worker, with their ids for filtering and writes.
smarthr_list_gradesList grades (等級) with their rank.
smarthr_list_job_categoriesList job categories (職種).
smarthr_list_companiesList the companies (会社) of the tenant: name, code, corporate number, address, phone.
smarthr_list_business_establishmentsList business establishments (事業所): name, social insurance and labor insurance registration data, company.
smarthr_list_employee_custom_fieldsList 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_relationsList the relation types for dependents (続柄: spouse, child, parent...) with their ids, needed by smarthr_create_dependent.
smarthr_list_usersList 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_formsList the employee information collection forms (従業員情報収集フォーム) that an invitation can use.
smarthr_list_webhooksList 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_employeeWRITE: 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_employeeWRITE: 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_departmentWRITE: Create a department (部署). Give the parent department id to nest it. Returns the created department.
smarthr_update_departmentWRITE: Rename or move one department (partial update: only the fields you give change). Returns the updated department.
smarthr_create_dependentWRITE: 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_employeeWRITE, 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
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
The registry name was verified against the domain usefulapi.io (the registry checks domain ownership)
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Responded in 15 ms (HTTP 200)
No sign-in needed
Read 23 tool descriptions and found no hidden instructions to the AI
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
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.
The registry does not list a required key, though some servers ask you to sign in on first use.
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.
The GitHub repo last changed –, and the latest version (1.6.3) reached the registry yesterday.
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.
In the same category: Spec Driven Development, Remote Desktop Commander, FOGA node
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
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
A Finch OG Agent cell as an MCP server: read the world, dry-run and take ERC-8414 tenders by policy.
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.
Connect your API-enabled SmartHR account.
https://smarthr.usefulapi.io/mcp.claude mcp add --transport http smarthr https://smarthr.usefulapi.io/mcp, then run /mcp to log in.{
"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/
| Tool | Type | What it does |
|---|---|---|
smarthr_list_employees | read | List employees |
smarthr_get_employee | read | Get an employee |
smarthr_list_dependents | read | List an employee's dependents |
smarthr_list_maternity_childcare_leaves | read | List an employee's maternity and childcare leaves |
smarthr_list_departments | read | List departments |
smarthr_get_department | read | Get a department |
smarthr_list_positions | read | List positions |
smarthr_list_employment_types | read | List employment types |
smarthr_list_grades | read | List grades |
smarthr_list_job_categories | read | List job categories |
smarthr_list_companies | read | List companies |
smarthr_list_business_establishments | read | List business establishments |
smarthr_list_employee_custom_fields | read | List employee custom field definitions |
smarthr_list_dependent_relations | read | List dependent relations |
smarthr_list_users | read | List users |
smarthr_list_employee_input_forms | read | List employee input forms |
smarthr_list_webhooks | read | List webhooks |
smarthr_create_employee | write | Create an employee |
smarthr_update_employee | write | Update an employee |
smarthr_create_department | write | Create a department |
smarthr_update_department | write | Update a department |
smarthr_create_dependent | write | Create a dependent |
smarthr_invite_employee | write | Invite an employee by email |
smarthr_usage_status | meta | Usage status (free-tier meter) |
smarthr_request_feature | meta | Request a missing feature |
smarthr_upgrade | meta | Upgrade to Pro or Pro+ |
smarthr_cancel_subscription | meta | Cancel 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.
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 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.
MIT