一个实用、可本地运行的 HR 助手，用于员工入职、休假跟踪、工作协调及工作场所请求。它可以连接到任何与 MCP 兼容的客户端，且无需数据库或付费服务即可运行。
MCP 服务器是 HR 工作流的唯一入口。员工、休假、会议和请求功能分别作为独立模块实现，邮件交付保持可选。数据以本地内存形式存储，便于快速演示体验。
Related MCP server: multi-mail-mcp
通过一次性工具调用即可完成员工入职。
维护员工目录，包含经理与直接下属关系。
查看休假余额、提交休假申请、浏览休假历史。
安排、列出或取消入职培训或 HR 会议。
创建和更新笔记本电脑、耳机、门禁卡及其他工作场所请求。
在本地配置好 SMTP 账号后，即可通过 SMTP 发送通知。
内置确定性的员工示例，便于立即测试。
要求：Python 3.10 或更高版本。
git clone https://github.com/sarthak-here/hr-assistant-mcp.git
cd hr-assistant-mcp
python -m pip install -e ".[test]"
python server.py服务器通过标准输入/标准输出进行通信，这正是 MCP 客户端的预期方式。出厂时不会显示交互式聊天提示。
每当你做出更改时，请运行测试套件：
python -m pytest在客户端配置中使用克隆项目的绝对路径。
{
"mcpServers": {
"hr-assistant": {
"command": "python",
"args": ["C:\\path\\to\\hr-assistant-mcp\\server.py"]
}
}
}连接后，请尝试以下请求之一：
Show the current employee directory.
Onboard Priya Shah as a Product Analyst reporting to EMP-002.
Check the leave balance for EMP-003.
Create a monitor request for EMP-004.类别 | 工具 |
员工目录 |
|
休假 |
|
会议 |
|
工作场所请求 |
|
入职 |
|
通知 |
|
onboard_employee 会同时创建员工记录、休假账户，以及标准的笔记本电脑、耳机和门禁卡请求。待时间确认后，再另行安排入场培训。
邮件功能是可选的。将 .env.example 复制为 .env，如果有需要用到 send_notification 时，则补充 SMTP 配置信息。
Copy-Item .env.example .env.env 文件会被 Git 忽略。其他所有 HR 功能无需邮件配置即可正常工作。
hr-assistant-mcp/
assets/ Hand-drawn system-design image
peopleops/ Domain models and HR workflow managers
tests/ Automated checks
server.py MCP tools
emails.py Optional SMTP notifications
.env.example Safe configuration template
pyproject.toml Project dependencies and test settingsThis server cannot be deployed
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
