SmartHR MCP by usefulapi

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

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.

Pricing

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 [email protected].

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 [email protected].

License

MIT