MCP server
CharlieHR MCP by usefulapi
Read CharlieHR team members, leave, allowances, offices, teams and salaries; add team…
- Runs
- Remotely
- Version
- 1.23.0
- Listing updated
- 4 days ago
About CharlieHR MCP by usefulapi
CharlieHR MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read CharlieHR team members, leave, allowances, offices, teams and salaries; add team member notes.
Install
Run in a terminal
claude mcp add --transport http charliehr https://charliehr.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://charliehr.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"charliehr": {
"url": "https://charliehr.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"charliehr": {
"type": "http",
"url": "https://charliehr.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"charliehr": {
"serverUrl": "https://charliehr.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"charliehr": {
"type": "http",
"url": "https://charliehr.usefulapi.io/mcp"
}
}
}Tools this server provides (27)
Read directly from the server.
- charliehr_get_company
- The Charlie company the API keys belong to: id, name, subdomain and logo. GET /company.
- charliehr_list_offices
- List the company's offices: id, name, whether it is the head office, address, timezone, phone and email. GET /offices.
- charliehr_get_office
- One office by id. GET /offices/{id}.
- charliehr_list_teams
- List the company's teams with the ids of their team members. GET /teams.
- charliehr_get_team
- One team by id, with the ids of its team members. GET /teams/{id}.
- charliehr_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.
- charliehr_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}.
- charliehr_get_team_member_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.
- charliehr_get_team_member_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.
- charliehr_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.
- charliehr_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.
- charliehr_get_leave_request
- One leave request by id. GET /leave_requests/{id}.
- charliehr_list_team_member_leave_requests
- The leave requests of one team member, optionally only those in a date window. GET /team_members/{id}/leave_requests.
- charliehr_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.
- charliehr_get_team_member_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.
- charliehr_list_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.
- charliehr_list_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.
- charliehr_list_leave_types
- The enabled leave types (Holiday, Sick...): id, name, deductible, default, auto-approved, sensitive. GET /leave_types.
- charliehr_get_leave_type
- One leave type by id. GET /leave_types/{id}.
- charliehr_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.
- charliehr_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.
- charliehr_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.
- charliehr_list_team_member_salaries
- SENSITIVE: the salary history of one team member (job title, pay rate, currency, effective date). GET /team_members/{id}/salaries.
- charliehr_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.
- charliehr_get_team_member_note_type
- One note type by id. GET /team_member_note_types/{id}.
- charliehr_list_team_member_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.
- charliehr_create_team_member_note
- 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.
CharlieHR MCP by usefulapi FAQ
How do I add CharlieHR MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http charliehr https://charliehr.usefulapi.io/mcp