CharlieHR MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.19.4更新于 Nov 7, 2026

Read CharlieHR team members, leave, allowances, offices, teams and salaries; add team member notes.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

托管的 CharlieHR 连接器,让助手读取员工、办公室、团队、休假、假期额度与薪资,并为员工添加备注。

可以做什么
  • 查询公司、办公室、团队以及含主管和职位信息的员工档案
  • 读取员工的工作地点与工作周安排
  • 列出休假申请、假期额度、额度调整、非假期休假余额、休假类型、公司假日与限制日期
  • 读取薪资记录与个人薪资历史(敏感,需薪资访问权限)
  • 列出员工备注类型与备注,并为员工新增自定义备注
  • 查看用量、提交功能请求、升级或取消订阅
适用场景
适合让助手直接基于 CharlieHR 回答人事问题,例如下周谁在休假、某人还剩多少假期额度、某办公室有哪些人及其主管是谁,无需切换工具。
运行要求
远程 MCP 端点,无需本地安装。通过 OAuth 登录:客户端配置中只填服务器地址,登录页需输入 CharlieHR 凭据(API client id 与 client secret)。免费方案每月 50 次工具调用,付费方案可提高上限。
安装前请注意
返回内容含敏感个人数据:出生日期、性别、婚姻状况、个人邮箱、电话、家庭住址、备注及薪资记录。国民保险号与薪资/税务字段会被移除,但其他个人数据不会。有一个写入工具:为员工添加备注会立即生效,并对该备注类型权限内的人可见,使用前请确认。付费方案需付费,通过 Stripe 结账链接订阅;取消后服务持续到已付周期结束且不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 CharlieHR MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fcharliehr/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "charliehr-by-usefulapi": {
      "type": "http",
      "url": "https://charliehr.usefulapi.io/mcp"
    }
  }
}

README

CharlieHR MCP by usefulapi

Use CharlieHR from Claude, Cursor, or any MCP client — read team members, offices, teams, working locations and working weeks, leave requests, leave allowances and adjustments, company holidays and salaries, and add a note to a team member (the write needs an explicit confirmation). National Insurance numbers are removed from replies, and payroll and tax fields are dropped. Hosted, no local install: connect with a CharlieHR API client id and client secret.

Live endpoint: https://charliehr.usefulapi.io/mcp · Homepage: https://usefulapi.io/charliehr

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://charliehr.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http charliehr https://charliehr.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:
json
{  "mcpServers": {    "charliehr": {      "url": "https://charliehr.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 CharlieHR credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/charliehr/

Tools

ToolTypeWhat it does
charliehr_get_companyreadGet company
charliehr_list_officesreadList offices
charliehr_get_officereadGet office
charliehr_list_teamsreadList teams
charliehr_get_teamreadGet team
charliehr_list_team_membersreadList team members
charliehr_get_team_memberreadGet team member
charliehr_get_team_member_working_locationreadGet a team member's working location
charliehr_get_team_member_working_weeksreadGet a team member's working weeks
charliehr_list_working_locationsreadList working locations
charliehr_list_leave_requestsreadList leave requests
charliehr_get_leave_requestreadGet leave request
charliehr_list_team_member_leave_requestsreadList a team member's leave requests
charliehr_list_leave_allowancesreadList leave allowances
charliehr_get_team_member_leave_allowancereadGet a team member's leave allowance
charliehr_list_allowance_adjustmentsreadList a team member's allowance adjustments
charliehr_list_non_holiday_leave_allowancesreadList a team member's non-holiday leave allowances
charliehr_list_leave_typesreadList leave types
charliehr_get_leave_typereadGet leave type
charliehr_list_company_holidaysreadList company holidays
charliehr_list_restricted_datesreadList restricted dates
charliehr_list_salariesreadList salaries
charliehr_list_team_member_salariesreadList a team member's salaries
charliehr_list_team_member_note_typesreadList team member note types
charliehr_get_team_member_note_typereadGet team member note type
charliehr_list_team_member_notesreadList a team member's notes
charliehr_create_team_member_notewriteAdd a note to a team member
charliehr_usage_statusmetaUsage status (free-tier meter)
charliehr_request_featuremetaRequest a missing feature
charliehr_upgrademetaUpgrade to Pro or Pro+
charliehr_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 tool calls / month
Pro (per company)$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 charliehr_upgrade (it returns a Stripe Checkout link). Cancel any time with charliehr_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running charliehr_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by CharlieHR.

来源:servers/charliehr/README.md,提交 4046075

工具

27

charliehr_get_company

Get company

The Charlie company the API keys belong to: id, name, subdomain and logo. GET /company.

无需输入参数。

charliehr_list_offices

List offices

List the company's offices: id, name, whether it is the head office, address, timezone, phone and email. GET /offices.

输入参数pageper_page

charliehr_get_office

Get office

One office by id. GET /offices/{id}.

输入参数office_id必填

charliehr_list_teams

List teams

List the company's teams with the ids of their team members. GET /teams.

输入参数pageper_page

charliehr_get_team

Get team

One team by id, with the ids of its team members. GET /teams/{id}.

输入参数team_id必填

charliehr_list_team_members

List team members

List the company's team members (employees): name, work and personal email, phone, address, office, manager, teams, job title, start date, employment status and leaving date. Sensitive fields included: date_of_birth, gender, married, personal email, phone and home address. National Insurance numbers, payroll id, starter declaration and student-loan flags are never returned. GET /team_members.

输入参数pageper_page

charliehr_get_team_member

Get team member

One team member by id with the full profile (contact details, address, office, manager, teams, dates, employment status, job title, notes). Sensitive fields included: date_of_birth, gender, married, personal email, phone, home address and notes. National Insurance numbers (also inside notes), payroll id, starter declaration and student-loan flags are never returned. GET /team_members/{id}.

输入参数team_member_id必填

charliehr_get_team_member_working_location

Get a team member's working location

Where one team member works on a date (custom overrides win over the default assignment). Defaults to today. GET /team_members/{id}/working_location.

输入参数dateteam_member_id必填

charliehr_get_team_member_working_weeks

Get a team member's working weeks

The working-week segments of one team member (which days are full_day/morning/afternoon, weekly hours, from/to dates), company defaults and custom overrides. Not paginated. GET /team_members/{id}/working_weeks.

输入参数team_member_id必填

charliehr_list_working_locations

List working locations

List the active working locations (the catalog). With a date, instead returns where each active team member works on that date. GET /working_locations.

输入参数datepageper_page

charliehr_list_leave_requests

List leave requests

List leave requests of the whole company (id, team member, approver, status, request type, start/end date, amount and units, duration, details). Optionally only those in a date window. GET /leave_requests.

输入参数pageend_dateper_pagestart_date

charliehr_get_leave_request

Get leave request

One leave request by id. GET /leave_requests/{id}.

输入参数leave_request_id必填

charliehr_list_team_member_leave_requests

List a team member's leave requests

The leave requests of one team member, optionally only those in a date window. GET /team_members/{id}/leave_requests.

输入参数pageend_dateper_pagestart_dateteam_member_id必填

charliehr_list_leave_allowances

List leave allowances

The current holiday allowance of every team member: allowance, used and remaining, in days and hours, with the leave period. GET /leave_allowances.

输入参数pageper_page

charliehr_get_team_member_leave_allowance

Get a team member's leave allowance

The current holiday allowance of one team member (allowance, used, remaining, in days and hours, with the period). GET /team_members/{id}/leave_allowance.

输入参数team_member_id必填

charliehr_list_allowance_adjustments

List a team member's allowance adjustments

All holiday allowance adjustments of one team member across every leave period (description, days/hours, carryover flag, creator, period). GET /team_members/{id}/allowance_adjustments.

输入参数pageper_pageteam_member_id必填

charliehr_list_non_holiday_leave_allowances

List a team member's non-holiday leave allowances

Days taken and limit for each non-holiday leave type (sick, compassionate...) of one team member. GET /team_members/{id}/non_holiday_leave_allowances.

输入参数team_member_id必填

charliehr_list_leave_types

List leave types

The enabled leave types (Holiday, Sick...): id, name, deductible, default, auto-approved, sensitive. GET /leave_types.

输入参数pageper_page

charliehr_get_leave_type

Get leave type

One leave type by id. GET /leave_types/{id}.

输入参数leave_type_id必填

charliehr_list_company_holidays

List company holidays

The company's holidays (bank holidays and closures): name, start/end date, duration, deductible. Optionally only those in a date window. GET /company_holidays.

输入参数pageend_dateper_pagestart_date

charliehr_list_restricted_dates

List restricted dates

The dates on which leave is restricted (e.g. a year-end freeze): name, start/end date, duration. Optionally only those in a date window. GET /restricted_dates.

输入参数pageend_dateper_pagestart_date

charliehr_list_salaries

List salaries

SENSITIVE: the salary records of all team members (job title, pay rate, pay period, frequency, currency, effective date, employment type). Needs API keys with access to salary data. GET /salaries.

输入参数pageper_page

charliehr_list_team_member_salaries

List a team member's salaries

SENSITIVE: the salary history of one team member (job title, pay rate, currency, effective date). GET /team_members/{id}/salaries.

输入参数pageper_pageteam_member_id必填

charliehr_list_team_member_note_types

List team member note types

The custom note types (fields such as Employee No. or Laptop Serial Number) with who may see them. GET /team_member_note_types.

输入参数pageper_page

charliehr_get_team_member_note_type

Get team member note type

One note type by id. GET /team_member_note_types/{id}.

输入参数note_type_id必填

charliehr_list_team_member_notes

List a team member's notes

The custom notes (label and content) stored on one team member (the content of a note labelled as a National Insurance number, and NI-number-looking text, is redacted). GET /team_members/{id}/notes.

输入参数pageper_pageteam_member_id必填

charliehr_create_team_member_note

Add a note to a team member

WRITE: add a custom note (a value for one note type, e.g. an employee number) to a team member in Charlie. It is created immediately and visible to whoever the note type's permissions allow. Use charliehr_list_team_member_note_types for the note type id. POST /team_members/{id}/notes.

输入参数content必填team_member_id必填team_member_note_type_id必填

版本历史

16
  1. v1.19.4最新Nov 7, 2026
  2. v1.18.3Nov 5, 2026
  3. v1.18.2Nov 5, 2026
  4. v1.18.1Nov 4, 2026
  5. v1.18.0Nov 3, 2026
  6. v1.17.1Nov 3, 2026
  7. v1.16.0Nov 1, 2026
  8. v1.14.0Oct 31, 2026
  9. v1.13.0Oct 31, 2026
  10. v1.12.2Oct 30, 2026
  11. v1.12.0Oct 30, 2026
  12. v1.7.0Oct 26, 2026
  13. v1.4.3Oct 25, 2026
  14. v1.4.0Oct 25, 2026
  15. v1.3.0Oct 24, 2026
  16. v1.0.0Oct 23, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成