Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.
Nothing to run from here
CharlieHR MCP by usefulapi is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
93/100
tool-list score
27
tools declared
remote
at its publisher
—
calls last 7d
What it does
Read CharlieHR team members, leave, allowances, offices, teams and salaries; add team member notes.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http charliehr-mcp-by-usefulapi https://charliehr.usefulapi.io/mcp
# 2 — ask your agent for something these tools do
# charliehr_get_company, charliehr_list_offices, charliehr_get_office and 24 more
CharlieHR MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
USAll 598 servers
usefulapi598 servers
25 categories
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http charliehr-mcp-by-usefulapi https://charliehr.usefulapi.io/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
27 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
The Charlie company the API keys belong to: id, name, subdomain and logo. GET /company.
No parameter schema on file.
List the company's offices: id, name, whether it is the head office, address, timezone, phone and email. GET /offices.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
One office by id. GET /offices/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| office_id | string | yes | Charlie office id, e.g. office_XXXX (see charliehr_list_offices). |
List the company's teams with the ids of their team members. GET /teams.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
One team by id, with the ids of its team members. GET /teams/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_id | string | yes | Charlie team id, e.g. team_XXXX (see charliehr_list_teams). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id, e.g. team_member_XXX (see charliehr_list_team_members). |
Where one team member works on a date (custom overrides win over the default assignment). Defaults to today. GET /team_members/{id}/working_location.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
| date | string | no | Date, yyyy-mm-dd (default today). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
List the active working locations (the catalog). With a date, instead returns where each active team member works on that date. GET /working_locations.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| date | string | no | Date, yyyy-mm-dd: return each team member's resolved location on that day. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| start_date | string | no | Only items overlapping this window: start date, yyyy-mm-dd. Must be used together with end_date. |
| end_date | string | no | End date, yyyy-mm-dd. Must be used together with start_date. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
One leave request by id. GET /leave_requests/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| leave_request_id | string | yes | Charlie leave request id, e.g. leave_request_XXX. |
The leave requests of one team member, optionally only those in a date window. GET /team_members/{id}/leave_requests.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
| start_date | string | no | Only items overlapping this window: start date, yyyy-mm-dd. Must be used together with end_date. |
| end_date | string | no | End date, yyyy-mm-dd. Must be used together with start_date. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
The current holiday allowance of every team member: allowance, used and remaining, in days and hours, with the leave period. GET /leave_allowances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
The current holiday allowance of one team member (allowance, used, remaining, in days and hours, with the period). GET /team_members/{id}/leave_allowance.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
Days taken and limit for each non-holiday leave type (sick, compassionate...) of one team member. GET /team_members/{id}/non_holiday_leave_allowances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
The enabled leave types (Holiday, Sick...): id, name, deductible, default, auto-approved, sensitive. GET /leave_types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
One leave type by id. GET /leave_types/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| leave_type_id | string | yes | Charlie leave type id, e.g. leave_type_XXX. |
The company's holidays (bank holidays and closures): name, start/end date, duration, deductible. Optionally only those in a date window. GET /company_holidays.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| start_date | string | no | Only items overlapping this window: start date, yyyy-mm-dd. Must be used together with end_date. |
| end_date | string | no | End date, yyyy-mm-dd. Must be used together with start_date. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| start_date | string | no | Only items overlapping this window: start date, yyyy-mm-dd. Must be used together with end_date. |
| end_date | string | no | End date, yyyy-mm-dd. Must be used together with start_date. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
SENSITIVE: the salary history of one team member (job title, pay rate, currency, effective date). GET /team_members/{id}/salaries.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
The custom note types (fields such as Employee No. or Laptop Serial Number) with who may see them. GET /team_member_note_types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
One note type by id. GET /team_member_note_types/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| note_type_id | string | yes | Charlie note type id, e.g. team_member_note_type_XXX. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | no | Results per page, 1-25 (default 25). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| team_member_id | string | yes | Charlie team member id. |
| team_member_note_type_id | string | yes | The note type this note belongs to (team_member_note_type_XXX). |
| content | string | yes | The note's content. |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install CharlieHR MCP by usefulapi or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
ATool-list grade · score 93 / 100
Release 1.19.2 · scanned 7 Nov 2026
Graded from the tools this server lists, not from its source code.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
Threat score100
Client score93
Findings0 threat · 1 capability
Capabilitymoderate
Coveragemanifest
Verificationnot in this report
Surface digestfb6632a9e1ac7bdd5bc13073cceed32e6327d06d3852d81e0ad96e05e224f841
Score vectorthreat 100 → client 93
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
Tool surfaceread
Implementation sourcenot available
Package metadatanot available
Live transportnot available
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| charliehr_get_company | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_offices | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_office | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_teams | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_team | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_team_members | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_team_member | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_team_member_working_location | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_team_member_working_weeks | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_working_locations | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_leave_requests | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_leave_request | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_team_member_leave_requests | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_leave_allowances | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_team_member_leave_allowance | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_allowance_adjustments | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_non_holiday_leave_allowances | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_leave_types | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_leave_type | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_company_holidays | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_restricted_dates | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_salaries | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_team_member_salaries | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_team_member_note_types | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_get_team_member_note_type | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_list_team_member_notes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| charliehr_create_team_member_note | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
flow-1
Untrusted input can drive an external action even though no sensitive source is exposed.
Supply chain and provenance
Integrityfirst-seen
Surface digestfb6632a9e1ac7bdd
Scanned2026-11-07
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.19.2.
1.19.2
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish CharlieHR MCP by usefulapi can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.