MCP server

CharlieHR MCP by usefulapi

io.usefulapi/charliehr

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

27

Token cost

About 4,775 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http charliehr https://charliehr.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.charliehr]
url = "https://charliehr.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"charliehr":{"httpUrl":"https://charliehr.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"charliehr":{"url":"https://charliehr.usefulapi.io/mcp"}}}

VS Code

{"servers":{"charliehr":{"type":"http","url":"https://charliehr.usefulapi.io/mcp"}}}

Antigravity

agy mcp add charliehr https://charliehr.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"charliehr","server_url":"https://charliehr.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"charliehr","server_url":"https://charliehr.usefulapi.io/mcp"}

Tools

• charliehr_create_team_member_note ~250 tokens
  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_get_company ~70 tokens
  The Charlie company the API keys belong to: id, name, subdomain and logo. GET /company.
• charliehr_get_leave_request ~108 tokens
  One leave request by id. GET /leave_requests/{id}.
• charliehr_get_leave_type ~102 tokens
  One leave type by id. GET /leave_types/{id}.
• charliehr_get_office ~102 tokens
  One office by id. GET /offices/{id}.
• charliehr_get_team ~107 tokens
  One team by id, with the ids of its team members. GET /teams/{id}.
• charliehr_get_team_member ~212 tokens
  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), payrol
• charliehr_get_team_member_leave_allowance ~133 tokens
  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_get_team_member_note_type ~110 tokens
  One note type by id. GET /team_member_note_types/{id}.
• charliehr_get_team_member_working_location ~165 tokens
  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 ~148 tokens
  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_allowance_adjustments ~216 tokens
  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_company_holidays ~264 tokens
  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_leave_allowances ~166 tokens
  The current holiday allowance of every team member: allowance, used and remaining, in days and hours, with the leave period. GET /leave_allowances.
• charliehr_list_leave_requests ~276 tokens
  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_list_leave_types ~156 tokens
  The enabled leave types (Holiday, Sick...): id, name, deductible, default, auto-approved, sensitive. GET /leave_types.
• charliehr_list_non_holiday_leave_allowances ~132 tokens
  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_offices ~155 tokens
  List the company's offices: id, name, whether it is the head office, address, timezone, phone and email. GET /offices.
• charliehr_list_restricted_dates ~264 tokens
  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 ~177 tokens
  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_leave_requests ~293 tokens
  The leave requests of one team member, optionally only those in a date window. GET /team_members/{id}/leave_requests.
• charliehr_list_team_member_note_types ~162 tokens
  The custom note types (fields such as Employee No. or Laptop Serial Number) with who may see them. GET /team_member_note_types.
• charliehr_list_team_member_notes ~219 tokens
  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_list_team_member_salaries ~200 tokens
  SENSITIVE: the salary history of one team member (job title, pay rate, currency, effective date). GET /team_members/{id}/salaries.
• charliehr_list_team_members ~235 tokens
  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
• charliehr_list_teams ~141 tokens
  List the company's teams with the ids of their team members. GET /teams.
• charliehr_list_working_locations ~212 tokens
  List the active working locations (the catalog). With a date, instead returns where each active team member works on that date. GET /working_locations.

Browse

• Email

Related MCP servers

• Bilflo MCP by usefulapi
  Read Bilflo clients, contract jobs, contractors and reports; update jobs, terminate or reopen them.
• RotaCloud MCP by usefulapi
  Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.
• Spruce Health MCP by usefulapi
  Read Spruce Health contacts, conversations, messages, phone lines and team members (read-only).
• kiwiHR MCP by usefulapi
  Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.
• Hook Detector
  Real TikTok and Instagram hooks that already work, in any language, with why each travelled.
• handoff — agent swarm coordination
  Agent swarm coordination: find funded work, form teams, run tasks, message E2E, get paid on verify.
• Breathe HR MCP by usefulapi
  Read Breathe HR employees, absences, sickness and leave; create and review leave requests.
• Parabol MCP by usefulapi
  Start Parabol retrospectives, standups and sprint poker; read teams/meetings/tasks; create tasks.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/charliehr.svg)](https://aptlynx.net/servers/io.usefulapi/charliehr)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents