smarthr_mcp_server
SmartHR MCP Server is a Model Context Protocol server designed to interface with the SmartHR API, allowing management of employee, department, job title, employment type, and grade information as MCP tools.
SmartHR MCP Server
このプロジェクトは、SmartHR API に対応した MCP (Model Context Protocol) サーバーです。 SmartHR の従業員・部署・役職・雇用形態・等級などの情報を MCP ツールとして扱うことができます。
構成
smarthr-mcp-server/
│
├── .env_sample
├── .gitignore
├── main.py
├── pyproject.toml
├── README.md
├── requirements.txt
├── smarthr_mcp_server.json # MCP ツールとしての定義とコマンド情報（MCP 対応クライアント用）
├── uv.lock
│
└── smarthr_mcp_server/
├── server.py # FastMCP ベースの MCP サーバー実装
├── smarthr_client.py # SmartHR API との通信を担当するクライアントモジュール
└── smarthr_mcp_server.egg-info/
環境変数（.env）
SmartHR API との通信には以下の環境変数が必要です。
SMARTHR_API_BASE_URL=https://app.smarthr.jp/api
SMARTHR_API_KEY=YOUR_SMARTHR_API_TOKEN
使い方
-
リポジトリをクローンまたはダウンロード
-
環境変数の設定（.env）
-
Claude for Desktop の設定
claud_desktop_config.jsonに smarthr_mcp_server.json の内容を追記 -
Claude for Desktop の再起動
% killall "Claude" % open -a Claude
対応ツール一覧
登録 関連
| 関数名 | 説明 |
|---|---|
smarthr_create_crew() | 従業員 |
smarthr_create_department() | 部署 |
smarthr_create_dependent() | 家族情報 |
smarthr_create_employment_type() | 雇用形態 |
smarthr_create_grade() | 等級 |
smarthr_create_job_category() | 職種 |
smarthr_create_job_title() | 役職 |
削除 関連
| 関数名 | 説明 |
|---|---|
smarthr_delete_crew() | 従業員 |
smarthr_delete_dependent() | 家族情報 |
smarthr_delete_employment_type() | 雇用形態 |
smarthr_delete_grade() | 等級 |
smarthr_delete_job_category() | 職種 |
smarthr_delete_job_title() | 役職 |
廃止 関連
| 関数名 | 説明 |
|---|---|
smarthr_discontinue_department() | 部署 |
取得 関連
| 関数名 | 説明 |
|---|---|
smarthr_get_crew() | 従業員 |
smarthr_get_department() | 部署 |
smarthr_get_dependent() | 家族情報 |
smarthr_get_employment_type() | 雇用形態 |
smarthr_get_grade() | 等級 |
smarthr_get_job_category() | 職種 |
smarthr_get_job_title() | 役職 |
招待 関連
| 関数名 | 説明 |
|---|---|
smarthr_invite_crew() | 従業員 |
リスト取得 関連
| 関数名 | 説明 |
|---|---|
smarthr_list_crews() | 従業員 |
smarthr_list_departments() | 部署 |
smarthr_list_dependents() | 家族情報 |
smarthr_list_employment_types() | 雇用形態 |
smarthr_list_grades() | 等級 |
smarthr_list_job_categories() | 職種 |
smarthr_list_job_titles() | 役職 |
smarthr_list_relations() | 続柄 |
部分更新 関連
| 関数名 | 説明 |
|---|---|
smarthr_partial_update_department() | 部署 |
smarthr_partial_update_dependent() | 家族情報 |
smarthr_partial_update_employment_type() | 雇用形態 |
smarthr_partial_update_grade() | 等級 |
smarthr_partial_update_job_category() | 職種 |
smarthr_partial_update_job_title() | 役職 |
検索 関連
| 関数名 | 説明 |
|---|---|
smarthr_search_crews() | 従業員 |
更新 関連
| 関数名 | 説明 |
|---|---|
smarthr_update_crew() | 従業員 |
smarthr_update_department() | 部署 |
smarthr_update_dependent() | 家族情報 |
smarthr_update_employment_type() | 雇用形態 |
smarthr_update_grade() | 等級 |
smarthr_update_job_category() | 職種 |
smarthr_update_job_title() | 役職 |
ライセンス
MIT
免責事項
本プログラムを利用して行う一切の行為、被った損害・損失に対しては、一切の責任を負いかねます。
Related MCP Servers
View all customer_data_platforms servers →mcp-hubspot
by peakmojo
A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data.
woocommerce-mcp-server
by techspawn
A Model Context Protocol (MCP) server for WooCommerce integration, compatible with Windows, macOS, and Linux.
freshdesk_mcp
by effytech
An MCP server implementation that integrates with Freshdesk, enabling AI models to interact with Freshdesk modules and perform various support operations.
salesforce-mcp-server
by kablewy
A Model Context Protocol server implementation for interacting with Salesforce through its REST API using jsforce.
mcp-dynamics365-server
by srikanth-paladugula
The Microsoft Dynamics 365 MCP Server is a Model Context Protocol server that facilitates interaction with Microsoft Dynamics 365, allowing operations such as retrieving user information, managing accounts, and handling opportunities.
apollo-io-mcp-server
by lkm1developer
A powerful Model Context Protocol (MCP) server implementation for seamless Apollo.io API integration, enabling AI assistants to interact with Apollo.io data.