usefulapiCharlieHR MCP server
Read CharlieHR team members, leave, allowances, offices, teams and salaries; add team member notes. Hosted by usefulapi: connect it to Claude, ChatGPT, Cursor or any MCP client.
What can I ask?
Turn on the CharlieHR connector, then ask in plain words. The AI picks the tools.
- Who is off on leave next week?
- How much holiday allowance does each team member have left this year?
- Show me the team members in the London office and who their managers are.
- Add the employee number ABC123 as a note on Jane Doe's profile.
What you can do with CharlieHR in Claude and ChatGPT
For HR and people teams at small companies who manage staff in CharlieHR.
See who is off on leave in a date window
The AI lists leave requests of the company in a date window, with team member, status, request type and dates, and the leave types.
Check the holiday allowance left per person
The AI reads the allowance, used and remaining days or hours of every team member, and the adjustments of one person.
List team members by office, team or manager
The AI lists team members with office, manager, teams, job title and start date, and the offices and teams of the company.
See where team members work on a day
The AI lists working locations, shows where each team member works on a date, and reads the working weeks of one person.
Check company holidays and restricted leave dates
The AI lists bank holidays and closures, and the dates when leave is restricted, such as a year-end freeze, in a date window.
Add a custom note to a team member's profile
The AI reads the note types, such as Employee No., and adds a note value to a team member. It is visible to whoever the note type allows.
Changes dataHow do I connect CharlieHR?
Before you connect
The login page asks for your CharlieHR client id and CharlieHR client secret.
In Charlie open Company → Integrations → API keys (a Super Admin or Admin) and generate a key pair; the secret is shown only once. The keys act for your whole company. Your keys are used only to call the CharlieHR API on your behalf; they are never shown to anyone.
Claude claude.ai · Desktop
- Open Customize → Connectors, then click + Add → Add custom connector.
- Enter the name CharlieHR and this URL, then click Add:https://
charliehr. usefulapi. io/ mcp - Claude opens the login page: enter your CharlieHR client id and CharlieHR client secret.
- In a chat, click + → Connectors and turn on CharlieHR.
Team and Enterprise: an Owner adds the connector for the organization first.
ChatGPT chatgpt.com
- Open Plugins, click +, then Add custom MCP server.
- Enter the name CharlieHR and this URL, choose OAuth as the authentication, confirm the warning and create it:https://
charliehr. usefulapi. io/ mcp - ChatGPT opens the login page: enter your CharlieHR client id and CharlieHR client secret.
- In Plugins, install CharlieHR, then choose it in a chat.
No Add custom MCP server option? It depends on your account or workspace settings: see OpenAI's guide.
Claude Code
Run this command, then run /mcp in Claude Code to log in:
Cursor
Add to Cursor or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"charliehr": {
"url": "https://charliehr.usefulapi.io/mcp"
}
}
} VS Code
Add to VS Code or add this to .vscode/mcp.json:
{
"servers": {
"charliehr": {
"type": "http",
"url": "https://charliehr.usefulapi.io/mcp"
}
}
} Codex
Run these commands. The second one opens the login page:
Other clients
Windsurf, Cline, Zed and other MCP clients: add this URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser.
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: the login page asks for your CharlieHR client id and CharlieHR client secret. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Proper company | $9/mo · $90/yr | 10,000 tool calls / month |
| Pro+per company | $39/mo · $390/yr | 100,000 tool calls / month |
Each paid plan covers this CharlieHR server only. Ask your AI to run charliehr_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with charliehr_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with charliehr_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
Tools 31
Show all 31 tools (the AI picks them for you)
Read only · 26
- Get company
charliehr_get_companyThe Charlie company the API keys belong to: id, name, subdomain and logo. - List offices
charliehr_list_officesList the company's offices: id, name, whether it is the head office, address, timezone, phone and email. - Get office
charliehr_get_officeOne office by id. - List teams
charliehr_list_teamsList the company's teams with the ids of their team members. - Get team
charliehr_get_teamOne team by id, with the ids of its team members. - List team members
charliehr_list_team_membersList 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 member
charliehr_get_team_memberOne 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 a team member's working location
charliehr_get_team_member_working_locationWhere one team member works on a date (custom overrides win over the default assignment). Defaults to today. - Get a team member's working weeks
charliehr_get_team_member_working_weeksThe 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. - List working locations
charliehr_list_working_locationsList the active working locations (the catalog). With a date, instead returns where each active team member works on that date. - List leave requests
charliehr_list_leave_requestsList 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 request
charliehr_get_leave_requestOne leave request by id. - List a team member's leave requests
charliehr_list_team_member_leave_requestsThe leave requests of one team member, optionally only those in a date window. - List leave allowances
charliehr_list_leave_allowancesThe current holiday allowance of every team member: allowance, used and remaining, in days and hours, with the leave period. - Get a team member's leave allowance
charliehr_get_team_member_leave_allowanceThe current holiday allowance of one team member (allowance, used, remaining, in days and hours, with the period). - List a team member's allowance adjustments
charliehr_list_allowance_adjustmentsAll holiday allowance adjustments of one team member across every leave period (description, days/hours, carryover flag, creator, period). - List a team member's non-holiday leave allowances
charliehr_list_non_holiday_leave_allowancesDays taken and limit for each non-holiday leave type (sick, compassionate...) of one team member. - List leave types
charliehr_list_leave_typesThe enabled leave types (Holiday, Sick...): id, name, deductible, default, auto-approved, sensitive. - Get leave type
charliehr_get_leave_typeOne leave type by id. - List company holidays
charliehr_list_company_holidaysThe company's holidays (bank holidays and closures): name, start/end date, duration, deductible. Optionally only those in a date window. - List restricted dates
charliehr_list_restricted_datesThe dates on which leave is restricted (e.g. a year-end freeze): name, start/end date, duration. Optionally only those in a date window. - List salaries
charliehr_list_salariesSENSITIVE: 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. - List a team member's salaries
charliehr_list_team_member_salariesSENSITIVE: the salary history of one team member (job title, pay rate, currency, effective date). - List team member note types
charliehr_list_team_member_note_typesThe custom note types (fields such as Employee No. or Laptop Serial Number) with who may see them. - Get team member note type
charliehr_get_team_member_note_typeOne note type by id. - List a team member's notes
charliehr_list_team_member_notesThe 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).
Changes data · 1
- Add a note to a team member
charliehr_create_team_member_noteWRITE: 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.
Your usefulapi plan · 4
- Usage status (free-tier meter)
charliehr_usage_statusReport the caller's current usage: the plan, calls used this month, the limit of the plan (the free monthly cap or the Pro fair use limit), remaining, and whether the limit is reached. Read-only; does not count against the meter. - Request a missing feature
charliehr_request_featureTell usefulapi that the user needs something the CharlieHR tools cannot do yet (a missing tool, field or filter). Call it only when the user asks for something none of the tools can do, and tell the user that you send the request. Do not call it for errors or for normal requests. Do not include personal data, credentials or customer records. Stored with the product name and the client type (for example Claude or Cursor), without the user's account. At most 5 requests per day. Does not count against the meter. - Upgrade to Pro or Pro+
charliehr_upgradeGet a paid plan for CharlieHR (the free tier caps monthly usage). Pro: 10,000 tool calls a month, for normal use — plan "monthly" ($9/month) or "yearly" ($90/year, 2 months free). Pro+: 100,000 tool calls a month, for automations and heavy use — plan "plus" ($39/month) or "plus_yearly" ($390/year). Without a plan it returns both Pro and Pro+, each with a payment link, for the user to choose; with a plan, one link. An existing Pro subscription changes to Pro+ in place: call without confirm first, as the reply states the exact charge for this account (the price difference for the rest of the period, or in a free Pro trial the full Pro+ price, as the trial ends); then call with confirm: true. Cancel any time: the plan then runs to the end of the paid period, so it also suits a one-time job. A link opens Stripe Checkout in the browser; after payment the account upgrades automatically. Does not count against the meter. - Cancel the Pro subscription
charliehr_cancel_subscriptionCancel the caller's CharlieHR Pro subscription at the end of the paid period (no refund for the current period; Pro continues until then, then the free tier applies). Requires confirm: true. Run charliehr_upgrade later to undo the cancel before the period ends. Does not count against the meter.
FAQ
What can I do with CharlieHR in Claude or ChatGPT?
See who is off on leave in a date window. Check the holiday allowance left per person. List team members by office, team or manager. See where team members work on a day. Check company holidays and restricted leave dates. Add a custom note to a team member's profile. See what you can do for the details.
Is this an official CharlieHR product?
No. usefulapi is an independent service. It is not affiliated with or endorsed by CharlieHR. The server calls the CharlieHR API with your own CharlieHR access, so it sees only the data that your account can see.
Can I connect CharlieHR to Claude or ChatGPT?
Yes. In Claude, add this server's URL as a custom connector. In ChatGPT, add it as a custom MCP server in Plugins. Then log in once. Cursor, VS Code, Claude Code and Codex work too. See the setup steps.
What do I need to connect?
The login page asks for your CharlieHR client id and CharlieHR client secret. See Before you connect for where to find them.
Do I put my CharlieHR key or an Authorization header in the client config?
No. 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: the login page asks for your CharlieHR client id and CharlieHR client secret. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
How do you keep my CharlieHR credentials?
The login stores them encrypted in the authorization grant of your connection. The server uses them to call the CharlieHR API for you and to derive a private account id for usage metering. usefulapi does not show them on any page or in any reply. To stop all access, remove the connector and change or delete these credentials in CharlieHR.
Can the AI change my CharlieHR data?
Yes, if you approve it. 1 of the 27 CharlieHR tools can create or change data. The other 26 are marked read-only. Most MCP clients ask you to approve a tool call before it runs.
What does it cost?
The Free plan gives 50 tool calls / month. Pro costs $9/mo or $90/yr, with 10,000 tool calls / month. Pro+ costs $39/mo or $390/yr, with 100,000 tool calls / month. Each subscription covers this CharlieHR server only. Cancel any time: your paid plan then runs to the end of the paid period. Run charliehr_usage_status to see how many calls you used.
How do I subscribe or cancel?
Ask the AI to run charliehr_upgrade and choose Pro or Pro+, billed monthly or yearly: it returns a Stripe Checkout link. If you already have Pro, ask to change it to Pro+. After you confirm, your existing subscription changes in place, keeps its billing interval and charges the price difference for the rest of the period immediately. To cancel, run charliehr_cancel_subscription. Your paid plan continues to the end of the paid period.
What if a CharlieHR tool that I need is missing?
Tell the AI what you wanted to do. It can send the request with charliehr_request_feature. We store the text with the server name, the type of AI client and the tool you tried, not with your account, and read every request when we plan new tools. You can send up to 5 requests per day.
Which AI clients can I use?
Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf and others.
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.
Need a tool this server does not have, or a connection to another system? We build custom integrations and MCP servers.