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.