SmartHR MCP Server

What is SmartHR MCP Server?

SmartHR MCP Server is an MCP (Model Context Protocol) server that integrates with the SmartHR API to provide tools for managing employees, departments, job titles, employment types, grades, and related data. It is intended for HR professionals and developers who use SmartHR and want to interact with its data through AI assistants like Claude.

How to use SmartHR MCP Server?

Clone the repository, set the required environment variables (SMARTHR_API_BASE_URL and SMARTHR_API_KEY) in a .env file, then configure Claude for Desktop by copying the contents of smarthr_mcp_server.json into the claud_desktop_config.json file. Restart Claude to load the tools.

Key features of SmartHR MCP Server

• Provides CRUD tools for employees, departments, families, employment types, grades, job categories, job titles, and relations.
• Supports searching employees and inviting new employees.
• Includes partial update and discontinue operations for specific entities.
• Built with FastMCP and communicates with the SmartHR API.
• Designed to be used with Claude for Desktop.
• Licensed under MIT.

Use cases of SmartHR MCP Server

• Manage employee records (create, read, update, delete) via conversation with an AI assistant.
• Automate department restructuring with discontinue and update tools.
• Quickly retrieve lists of job titles, grades, or employment types for reporting.
• Invite new employees directly from a chat interface.

FAQ from SmartHR MCP Server

What tools are available?

The server offers tools for create, delete, discontinue, get, invite, list, partial update, search, and update operations on entities such as crews (employees), departments, dependents, employment types, grades, job categories, and job titles.

What environment variables are required?

You must set SMARTHR_API_BASE_URL (e.g., https://app.smarthr.jp/api) and SMARTHR_API_KEY (your SmartHR API token) in a .env file.

Is Claude for Desktop required?

Yes, the README explains configuration specifically for Claude for Desktop by editing claud_desktop_config.json.

What license does this server use?

The server is licensed under MIT.

Where are the server’s dependencies listed?

Dependencies are listed in requirements.txt and managed with uv (see uv.lock).